Credentials. The API key must come from .env or environment variables and should never be pasted into YAML, the dashboard or shared logs.
Who it is forA researcher who wants to test real model behavior in the town and must keep API spending bounded.
The problemModel-driven runs call a paid provider, so credentials must be set safely and usage must be capped and auditable.
The outcomeAn LLM-mode smoke run in runs/llm-smoke with recorded model requests and responses, and a budget that stops the run at the last committed world state if exhausted.
What you need first
- Python 3.12 or 3.13 installed, with access to the python3.12 command on Linux
- A terminal opened at the repository root
- Internet access to install locked dependencies with uv
- For real model runs only: an API key and a Chat Completions compatible endpoint with tool calling
Steps
- Complete the install steps from the README Linux section so
.venvexists - Run
cp .env.example .env, then set TASS_API_KEY, TASS_BASE_URL and TASS_MODEL in.env(inferred, check the README) - Run
.venv/bin/python -m tass.cli run --config configs/smoke.yaml --mode llm --output runs/llm-smoke(inferred, check the README) - Review the recorded requests and budget use in the run database before running anything larger
Prompt for your agent
In the apromisedland/trustworthy-agent-simulation repo, check that TASS_API_KEY, TASS_BASE_URL and TASS_MODEL are set in .env without printing the key, then ask the user to confirm before running configs/smoke.yaml in --mode llm into runs/llm-smoke. Report the number of requests and tokens used against the default budget of 500 requests, 1,000,000 input tokens and 100,000 output tokens. Verify that the run stops at the last committed state if the budget is exhausted.
Caveat. Cost figures are estimates only, shown when prices are configured, and are not provider billing data.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for apromisedland/trustworthy-agent-simulation and "Run the smoke scenario with a real model and budget cap"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer