smello-server 0.8.0

A local web dashboard for inspecting outgoing HTTP requests from your code

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

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

Requires

• Python >= 3.14

Links

• Documentation
• Source & Issues
• Changelog
• smello client SDK on PyPI