Who it is forA researcher or developer who wants to see how the default synthetic town behaves before changing anything.
The problemReading simulation logs by hand makes it hard to see locations, contracts, cash flow and who knew what.
The outcomeA committed offline run in runs/demo that you can browse in the local dashboard, with a location map, relationship network, agent state, contracts, cash distribution, economic indicators, event audit and timeline replay.
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
- Run
python3.12 -m venv .venv - Run
.venv/bin/python -m pip install uv==0.12.20 - Run
.venv/bin/uv sync --frozen --extra dev --inexact - Run
.venv/bin/python -m tass.cli run --config configs/town.yaml --output runs/demo - Run
.venv/bin/python -m tass.cli dashboard, then open http://127.0.0.1:8501 and check the map, contracts and event audit
Prompt for your agent
In the apromisedland/trustworthy-agent-simulation repo, set up the environment as the README Linux section describes, then run configs/town.yaml into runs/demo. Report the number of ticks committed and the path of the output folder. Verify that runs/demo contains run.sqlite, events.jsonl, metrics.csv and run.json.
Caveat. The default town is a synthetic research environment and its output does not show real-world economic or policy effects.
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 default town and inspect it in the dashboard"
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