Smello logo

Smello Server

A local web dashboard for inspecting outgoing and incoming HTTP requests, 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, unhandled exceptions, and (optionally) log records are captured automatically — no code changes needed.

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, 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
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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smello_server-0.10.0.tar.gz (295.0 kB view details)

Uploaded Jul 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

smello_server-0.10.0-py3-none-any.whl (285.7 kB view details)

Uploaded Jul 27, 2026 Python 3

File details

Details for the file smello_server-0.10.0.tar.gz.

File metadata

Download URL: smello_server-0.10.0.tar.gz
Upload date: Jul 27, 2026
Size: 295.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for smello_server-0.10.0.tar.gz
Algorithm	Hash digest
SHA256	`cb495f3074ea70ad5483081cadfce392dd09e5258e49997fd7f2184da799e451`
MD5	`8f352fc5b03906ef518266ed15cbb862`
BLAKE2b-256	`252749fb6bf46cf947c198803b01480981e61a3c216d6823706ff8bc4af02911`

See more details on using hashes here.

Provenance

The following attestation bundles were made for smello_server-0.10.0.tar.gz:

Publisher: publish-server.yml on smelloscope/smello

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: smello_server-0.10.0.tar.gz
- Subject digest: cb495f3074ea70ad5483081cadfce392dd09e5258e49997fd7f2184da799e451
- Sigstore transparency entry: 2257475783
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: smelloscope/smello@38c7493b386b39b43b3f71302483555d730b2f97
- Branch / Tag: refs/tags/smello-server/v0.10.0
- Owner: https://github.com/smelloscope
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-server.yml@38c7493b386b39b43b3f71302483555d730b2f97
- Trigger Event: push