smello-setup

Plans integration of Smello HTTP, log, and exception capture into Python projects.

78|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/smelloscope/smello --skill smello-setup-smelloscope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smello-setup
Source: https://github.com/smelloscope/smello/tree/main/skills/smello-setup
Command: npx skills add https://github.com/smelloscope/smello --skill smello-setup-smelloscope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up request monitoring and debug logging in a Python project requires figuring out package managers, entrypoints, middleware, and server configuration by hand. This Skill explores your codebase and proposes a concrete, tailored plan to integrate Smello so HTTP requests, logs, and exceptions appear in a local dashboard. ## Core Features & Use Cases - Codebase Exploration: Detects your package manager (pip, uv, poetry, pipenv), HTTP libraries (requests, httpx, aiohttp, grpc, botocore), logging usage, application entrypoints, and Docker setup. - Activation Planning: Recommends either code-level activation via smello.init() or the zero-code smello run wrapper, with exact file placement for Django, Flask, FastAPI, and CLI apps. - Server & Middleware Setup: Proposes FastAPI/Django middleware for incoming requests and offers Docker Compose or dev-dependency options for the Smello server. - Use Case: You inherit a FastAPI project and want to debug failing third-party API calls. The Skill inspects the repo, then presents a plan to add smello, wire the middleware, and start the dashboard at localhost:5110 — changing nothing until you approve. ## Quick Start Ask the agent to explore this Python project and propose a plan to integrate Smello for capturing HTTP requests, logs, and exceptions.

Frequently Asked Questions about smello-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add HTTP request monitoring to a Python project?

Install the smello package and either call smello.init() before any HTTP imports or prefix your command with smello run. Captured requests, logs, and exceptions appear in a local dashboard at http://localhost:5110.

How to capture outgoing API calls in FastAPI or Django?

Add the SmelloMiddleware to your FastAPI app or Django MIDDLEWARE setting to capture incoming requests, and run with smello run or smello.init() for outgoing calls. Outgoing capture works with requests, httpx, aiohttp, grpc, and botocore.

Does smello.init() affect production when the server is not running?

No. smello.init() only activates when the SMELLO_URL environment variable is set; otherwise it is a safe no-op with no patching, threads, or side effects. This lets you keep the call in production code without conditional imports.

Can I use Smello without changing my source code?

Yes. The smello run wrapper activates capture with zero source changes by prepending it to your existing command, such as smello run uvicorn app:app or smello run pytest tests/. Subprocess workers are instrumented automatically.

Which Python package managers does the setup support?

The setup plan covers pip with requirements.txt or pyproject.toml, uv, poetry, and pipenv. Smello is recommended as a regular dependency since it has zero dependencies and deactivates safely without SMELLO_URL.