Getting Started¶

Install¶

pip install AgentTinman

Initialize¶

python -m tinman.cli.main init

This creates: - .tinman/config.yaml - .env (template for provider keys)

If you are using PostgreSQL, initialize the database:

tinman db init

Configure Providers¶

Edit .env and add your keys. Example:

GEMINI_API_KEY=...
GITHUB_TOKEN=...

Update .tinman/config.yaml to pick a default model provider:

models:
  default: google
  providers:
    google:
      api_key: ${GEMINI_API_KEY}
      model: gemini-2.5-flash

Run a Research Cycle¶

tinman research --focus "tool use failures"

Generate a Demo Report¶

tinman report --format demo

Exclude synthetic demo failures:

tinman report --format markdown --exclude-demo-failures

Reset the local SQLite demo database:

tinman demo-reset-db

Launch the TUI¶

python -m tinman.cli.main tui