Smello Server
A local web dashboard for inspecting outgoing and incoming HTTP requests, pytest results, logs, and exceptions captured by the smello client SDK.
Setup
pip install smello-server
smello-server
Or run with Docker:
docker run -p 127.0.0.1:5110:5110 ghcr.io/smelloscope/smello
The server listens at http://localhost:5110.
Then install the client SDK and run your code with Smello:
pip install smello
smello run my_app.py
Outgoing HTTP requests, pytest results, unhandled exceptions, and optional log records are captured automatically.
Failed outgoing calls retain exception details. If a library raises after receiving a response, Smello stores both the response status and headers and the exception.
To capture tests, install the client with pip install "smello[pytest]". The bundled plugin supports pytest 7 and later.
Pytest events include runtime trace and span IDs plus stable collection memberships. Outgoing Requests, HTTPX, aiohttp, botocore, and gRPC calls inherit the active test membership as child operations. The dashboard always shows runtime parenthood. Its Group selector can add one available pytest level or remote-host grouping without changing event deep links. Virtual groups merge only across adjacent siblings, which preserves record order. Timeline filters retain matching records' runtime ancestors, so filtered children remain connected to their runtime context.
See Debug pytest tests with Smello for a runnable example and dashboard walkthrough.
Calls to the OpenAI, Anthropic, and Gemini APIs render as a readable conversation in the dashboard, with the system prompt, tool calls, and token usage broken out. The raw JSON stays one tab away.
API
Smello Server provides a JSON API for exploring captured events from the command line.
# List all captured events (unified timeline)
curl -s http://localhost:5110/api/events | python -m json.tool
# Filter by event type (http, http_incoming, test, log, exception)
curl -s 'http://localhost:5110/api/events?event_type=exception'
# Filter by method, host, status, or full-text search
curl -s 'http://localhost:5110/api/events?method=POST&host=api.stripe.com'
# Filter by app or session
curl -s 'http://localhost:5110/api/events?app=myapp&session=debug-payment'
# Get full event details
curl -s http://localhost:5110/api/events/{id} | python -m json.tool
# Clear all events
smello clear
# Equivalent HTTP API call
curl -X DELETE http://localhost:5110/api/events
CLI Options
smello-server --host 0.0.0.0 --port 5110 --db-path /tmp/smello.db # LAN access
Event retention
Smello Server deletes events older than seven days when it starts and every hour after that. Set SMELLO_RETENTION_DAYS to a non-negative integer to change the retention period:
SMELLO_RETENTION_DAYS=30 smello-server
Set it to 0 to keep events indefinitely. The server rejects negative or malformed values at startup.
Requires
- Python >= 3.14
Links
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file smello_server-0.12.0.tar.gz.
File metadata
- Download URL: smello_server-0.12.0.tar.gz
- Upload date:
- Size: 308.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c04796572ae86fbc57d2e8b93aed0e70a95156e5867bd2e9537d88f84cd4787
|
|
| MD5 |
89ae56b7cb1afff93fb466a0851522cc
|
|
| BLAKE2b-256 |
38a5d26656c4bcb49a4e79b8e09d0ffc9f7bbb72a7d416aca03442a8f1122bb6
|
Provenance
The following attestation bundles were made for smello_server-0.12.0.tar.gz:
Publisher:
publish-server.yml on smelloscope/smello
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
smello_server-0.12.0.tar.gz -
Subject digest:
4c04796572ae86fbc57d2e8b93aed0e70a95156e5867bd2e9537d88f84cd4787 - Sigstore transparency entry: 2339538348
- Sigstore integration time:
-
Permalink:
smelloscope/smello@48f394ee57175fd42c6c75d2569ed9993444f47d -
Branch / Tag:
refs/tags/smello-server/v0.12.0 - Owner: https://github.com/smelloscope
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-server.yml@48f394ee57175fd42c6c75d2569ed9993444f47d -
Trigger Event:
push
-
Statement type:
File details
Details for the file smello_server-0.12.0-py3-none-any.whl.
File metadata
- Download URL: smello_server-0.12.0-py3-none-any.whl
- Upload date:
- Size: 294.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39c5ec7a9925e4e1883968db900288808d6566b7120bc4bdd67752ed644ac7b1
|
|
| MD5 |
7b8b821116bb7946bf1fb91e13db2054
|
|
| BLAKE2b-256 |
d47a26035f6529fa6c6853e0751fdf3d84d9650760e12c33102a01ce2699c079
|
Provenance
The following attestation bundles were made for smello_server-0.12.0-py3-none-any.whl:
Publisher:
publish-server.yml on smelloscope/smello
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
smello_server-0.12.0-py3-none-any.whl -
Subject digest:
39c5ec7a9925e4e1883968db900288808d6566b7120bc4bdd67752ed644ac7b1 - Sigstore transparency entry: 2339538360
- Sigstore integration time:
-
Permalink:
smelloscope/smello@48f394ee57175fd42c6c75d2569ed9993444f47d -
Branch / Tag:
refs/tags/smello-server/v0.12.0 - Owner: https://github.com/smelloscope
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-server.yml@48f394ee57175fd42c6c75d2569ed9993444f47d -
Trigger Event:
push
-
Statement type:
