---
id: telepath
version: "0.3.1"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# telepath — A library for exchanging data between Python and JavaScript

License: permissive · Maintenance: dormant · Downloads: 884.6K/mo

## What it is and what it does

telepath is a Django library that bridges Python and JavaScript by serializing Python objects—including custom classes—into JSON-safe formats for transport to the browser, where matching JavaScript implementations deserialize them back into equivalent data structures. It works like pickle but with unpickling happening client-side in JavaScript rather than in Python.

The library lets you keep business logic on the server while building rich client-side interfaces. You register Python classes with corresponding JavaScript implementations, then telepath handles the packing and unpacking. It has no runtime dependencies and installs as a pure Python wheel, making setup straightforward for Django projects. However, maintenance is dormant as of the fact sheet date—the last release was 2023-06-12—so it receives no active development or bug fixes.

Use it for:

- Send complex Python data structures from Django views to JavaScript without manual JSON serialization or API endpoints.
- Register custom Python classes to enable automatic serialization of domain objects for client-side use.
- Build interactive Django admin interfaces or custom dashboards with rich JavaScript components backed by server-side Python logic.
- Reduce boilerplate in Django-to-frontend communication by eliminating hand-coded serialization and deserialization.
- Prototype or maintain legacy Django applications that rely on server-rendered templates with embedded JavaScript data.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

telepath serializes Python objects to JSON-compatible format for transmission to JavaScript, then deserializes them in the browser with matching JavaScript implementations, enabling bidirectional Python-JavaScript data exchange.

Yes, if you are actively maintaining a Django project and need Python-to-JavaScript data exchange without external APIs. The library is stable, has no dependencies, and works well for server-side-heavy Django apps. No, if you require active maintenance, security updates, or are building new projects—consider modern alternatives like REST APIs with frontend frameworks instead. Yes-with-conditions if your Django version and Python 3.8+ support are locked in and you accept dormant maintenance.

## Install

pip install telepath
uv add telepath
poetry add telepath

## Installing telepath

Before you install: Low friction: pure Python wheel with no runtime dependencies. Maintenance is dormant—last release was 2023-06-12 and no commits since 2024-09-26—so expect no active bug fixes or feature work, though the codebase is stable and marked Production/Stable.

License in practice: BSD license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install telepath

from telepath import Adapter, register

class MyAdapter(Adapter):
    js_constructor = 'MyClass'
    def pack(self, obj):
        return obj.to_dict()

register(MyAdapter(), MyClass)

Requires Python >=3.8 and a Django project; JavaScript counterpart must be implemented separately in the browser to unpack the serialized data.

Verify before relying:

- Whether dormant maintenance affects real-world stability for active Django projects using current versions of Django and Python.
- Extent of JavaScript implementation required per custom Python class and complexity of typical registration workflows.

## Package facts

- License: BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 884.6K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python javascript data serialization, django client-side data binding, python to javascript object mapping, cross-language data exchange, django browser communication, serialize python objects for javascript, python javascript bridge, django-integration, serialization

[View on SkillFed](https://skillfed.io/packages/telepath) · [View on PyPI](https://pypi.org/project/telepath/)