Skip to main content

ephem-debugger-py

Dev-only observability middleware for Python web frameworks. Part of the debugger project.

Captures HTTP requests, console output, and browser-side data from your dev server. AI agents query this data through the dbg CLI.

Preview — under active development.

Install

pip install ephem-debugger-py

FastAPI

from fastapi import FastAPI
from ephem_debugger_py.middleware.fastapi import instrument

app = FastAPI()
instrument(app, port=8000)

Flask

from flask import Flask
from ephem_debugger_py.middleware.flask import init_debugger

app = Flask(__name__)
init_debugger(app, port=5000)

Django

Add to settings.py:

MIDDLEWARE = [
    'ephem_debugger_py.middleware.django.DebuggerMiddleware',
    # ... other middleware
]

DEBUGGER_PORT = 8000

Query with CLI

npx dbg status
npx dbg server console
npx dbg browser console
npx dbg browser network

How it works

  1. Middleware captures HTTP request/response metadata and logging output
  2. IPC bridge exposes data via Unix socket (or TCP on Windows)
  3. Browser client script is auto-injected into HTML responses
  4. dbg CLI queries the session — works the same across all languages

Other languages

License

MIT

Metadata

Release files for ephem-debugger-py 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ephem-debugger-py 0.3.2
File Size Uploaded
ephem_debugger_py-0.3.2.tar.gz 12.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ephem-debugger-py 0.3.2
File Interpreter ABI Platform
ephem_debugger_py-0.3.2-py3-none-any.whl Python 3 none any Details

Total release size: 30.4 kB

Release files / ephem_debugger_py-0.3.2.tar.gz

Download URL ephem_debugger_py-0.3.2.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6f6427499715b76c3f1537ae074cc71ddbb32c84545258a36bc3bafae3b10971
BLAKE2b-256 checksum
How to use checksums
2b0b3ff076c7b12f08c8d4c3c61896131f66a64e0eec9c7f89831b05e4ae07d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / ephem_debugger_py-0.3.2-py3-none-any.whl

Download URL ephem_debugger_py-0.3.2-py3-none-any.whl
Size 18.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
76c9221ffa4388749a7b3d960f4b586389a3b4dca153eaa45edaf8abe48a43d5
BLAKE2b-256 checksum
How to use checksums
0fd0bf1855c7aa07283fecb426f8ac7bdbfc900de273eefdf79cd97c930b0d50
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.3.2 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page