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
- Middleware captures HTTP request/response metadata and logging output
- IPC bridge exposes data via Unix socket (or TCP on Windows)
- Browser client script is auto-injected into HTML responses
dbgCLI queries the session — works the same across all languages
Other languages
- Node.js —
@ephem-sh/debugger - Go —
ephem-debugger-go - Rust —
ephem-debugger-rs
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)
| File | Size | Uploaded | |
|---|---|---|---|
| ephem_debugger_py-0.3.2.tar.gz | 12.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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}
|