.env.example

# Timmy Time — Mission Control
# Copy this file to .env and uncomment lines you want to override.
# .env is gitignored and never committed.
#
# For cloud deployment, deploy/setup.sh generates this automatically.

# ── Cloud / Production ──────────────────────────────────────────────────────
# Your domain for automatic HTTPS via Let's Encrypt.
# Set to your actual domain (e.g., timmy.example.com) for HTTPS.
# Leave as "localhost" for IP-only HTTP access.
# DOMAIN=localhost

# Ollama host (default: http://localhost:11434)
# In production (docker-compose.prod.yml), this is set to http://ollama:11434 automatically.
# OLLAMA_URL=http://localhost:11434

# LLM model to use via Ollama (default: llama3.2)
# OLLAMA_MODEL=llama3.2

# Enable FastAPI interactive docs at /docs and /redoc (default: false)
# DEBUG=true

# ── AirLLM / big-brain backend ───────────────────────────────────────────────
# Inference backend: "ollama" (default) | "airllm" | "auto"
#   "auto" → uses AirLLM on Apple Silicon if installed, otherwise Ollama.
#   Requires: pip install ".[bigbrain]"
# TIMMY_MODEL_BACKEND=ollama

# AirLLM model size (default: 70b).
# 8b  ~16 GB RAM  |  70b  ~140 GB RAM  |  405b  ~810 GB RAM
# AIRLLM_MODEL_SIZE=70b

# ── L402 Lightning secrets ───────────────────────────────────────────────────
# HMAC secret for invoice verification.  MUST be changed in production.
# Generate with: python3 -c "import secrets; print(secrets.token_hex(32))"
# L402_HMAC_SECRET=<your-secret-here>

# HMAC secret for macaroon signing.  MUST be changed in production.
# L402_MACAROON_SECRET=<your-secret-here>

# Lightning backend: "mock" (default) | "lnd"
# LIGHTNING_BACKEND=mock

# ── Telegram bot ──────────────────────────────────────────────────────────────
# Bot token from @BotFather on Telegram.
# Alternatively, configure via the /telegram/setup dashboard endpoint at runtime.
# Requires: pip install ".[telegram]"
# TELEGRAM_TOKEN=

# ── Discord bot ──────────────────────────────────────────────────────────────
# Bot token from https://discord.com/developers/applications
# Alternatively, configure via the /discord/setup dashboard endpoint at runtime.
# Requires: pip install ".[discord]"
# Optional: pip install pyzbar Pillow  (for QR code invite detection from screenshots)
# DISCORD_TOKEN=
chore: pydantic-settings config, logging, CI workflow Config (src/config.py): - pydantic-settings Settings class: OLLAMA_URL, OLLAMA_MODEL, DEBUG - Reads from .env (gitignored) with sane defaults - settings singleton imported by health.py and agent.py Removes two hardcodes: - health.py: OLLAMA_URL="http://localhost:11434" → settings.ollama_url - agent.py: Ollama(id="llama3.2") → settings.ollama_model app.py: - logging.basicConfig at INFO — requests/errors now visible in terminal - docs_url/redoc_url gated on settings.debug (off by default) pyproject.toml: - pydantic-settings>=2.0.0 added to main dependencies - hatch wheel config updated to include src/config.py .env.example: documents all three env vars with inline comments .gitignore: add !.env.example negation so the template gets committed .github/workflows/tests.yml: runs pytest --cov on every push/PR (ubuntu-latest, Python 3.11, pip cache) All 27 tests pass. https://claude.ai/code/session_01M4L3R98N5fgXFZRvV8X9b6 2026-02-19 19:31:48 +00:00			`# Timmy Time — Mission Control`
			`# Copy this file to .env and uncomment lines you want to override.`
			`# .env is gitignored and never committed.`
feat: one-click cloud deployment — Caddy HTTPS, Ollama, systemd, cloud-init Add complete production deployment stack so Timmy can be deployed to any cloud provider (DigitalOcean, AWS, Hetzner, etc.) with a single command. New files: - docker-compose.prod.yml: production stack (Caddy auto-HTTPS, Ollama LLM, Dashboard, Timmy agent, Watchtower auto-updates) - deploy/Caddyfile: reverse proxy with security headers and WebSocket support - deploy/setup.sh: interactive one-click setup script for any Ubuntu/Debian server - deploy/cloud-init.yaml: paste as User Data when creating a cloud VM - deploy/timmy.service: systemd unit for auto-start on boot - deploy/digitalocean/create-droplet.sh: create a DO droplet via doctl CLI Updated: - Dockerfile: non-root user, healthcheck, missing deps (GitPython, moviepy, redis) - Makefile: cloud-deploy, cloud-up/down/logs/status/update/scale targets - .env.example: DOMAIN setting for HTTPS - .dockerignore: exclude deploy configs from image https://claude.ai/code/session_018CduUZoEJzFynBwMsxaP8T 2026-02-24 21:22:56 +00:00			`#`
			`# For cloud deployment, deploy/setup.sh generates this automatically.`

			`# ── Cloud / Production ──────────────────────────────────────────────────────`
			`# Your domain for automatic HTTPS via Let's Encrypt.`
			`# Set to your actual domain (e.g., timmy.example.com) for HTTPS.`
			`# Leave as "localhost" for IP-only HTTP access.`
			`# DOMAIN=localhost`
chore: pydantic-settings config, logging, CI workflow Config (src/config.py): - pydantic-settings Settings class: OLLAMA_URL, OLLAMA_MODEL, DEBUG - Reads from .env (gitignored) with sane defaults - settings singleton imported by health.py and agent.py Removes two hardcodes: - health.py: OLLAMA_URL="http://localhost:11434" → settings.ollama_url - agent.py: Ollama(id="llama3.2") → settings.ollama_model app.py: - logging.basicConfig at INFO — requests/errors now visible in terminal - docs_url/redoc_url gated on settings.debug (off by default) pyproject.toml: - pydantic-settings>=2.0.0 added to main dependencies - hatch wheel config updated to include src/config.py .env.example: documents all three env vars with inline comments .gitignore: add !.env.example negation so the template gets committed .github/workflows/tests.yml: runs pytest --cov on every push/PR (ubuntu-latest, Python 3.11, pip cache) All 27 tests pass. https://claude.ai/code/session_01M4L3R98N5fgXFZRvV8X9b6 2026-02-19 19:31:48 +00:00
			`# Ollama host (default: http://localhost:11434)`
feat: one-click cloud deployment — Caddy HTTPS, Ollama, systemd, cloud-init Add complete production deployment stack so Timmy can be deployed to any cloud provider (DigitalOcean, AWS, Hetzner, etc.) with a single command. New files: - docker-compose.prod.yml: production stack (Caddy auto-HTTPS, Ollama LLM, Dashboard, Timmy agent, Watchtower auto-updates) - deploy/Caddyfile: reverse proxy with security headers and WebSocket support - deploy/setup.sh: interactive one-click setup script for any Ubuntu/Debian server - deploy/cloud-init.yaml: paste as User Data when creating a cloud VM - deploy/timmy.service: systemd unit for auto-start on boot - deploy/digitalocean/create-droplet.sh: create a DO droplet via doctl CLI Updated: - Dockerfile: non-root user, healthcheck, missing deps (GitPython, moviepy, redis) - Makefile: cloud-deploy, cloud-up/down/logs/status/update/scale targets - .env.example: DOMAIN setting for HTTPS - .dockerignore: exclude deploy configs from image https://claude.ai/code/session_018CduUZoEJzFynBwMsxaP8T 2026-02-24 21:22:56 +00:00			`# In production (docker-compose.prod.yml), this is set to http://ollama:11434 automatically.`
chore: pydantic-settings config, logging, CI workflow Config (src/config.py): - pydantic-settings Settings class: OLLAMA_URL, OLLAMA_MODEL, DEBUG - Reads from .env (gitignored) with sane defaults - settings singleton imported by health.py and agent.py Removes two hardcodes: - health.py: OLLAMA_URL="http://localhost:11434" → settings.ollama_url - agent.py: Ollama(id="llama3.2") → settings.ollama_model app.py: - logging.basicConfig at INFO — requests/errors now visible in terminal - docs_url/redoc_url gated on settings.debug (off by default) pyproject.toml: - pydantic-settings>=2.0.0 added to main dependencies - hatch wheel config updated to include src/config.py .env.example: documents all three env vars with inline comments .gitignore: add !.env.example negation so the template gets committed .github/workflows/tests.yml: runs pytest --cov on every push/PR (ubuntu-latest, Python 3.11, pip cache) All 27 tests pass. https://claude.ai/code/session_01M4L3R98N5fgXFZRvV8X9b6 2026-02-19 19:31:48 +00:00			`# OLLAMA_URL=http://localhost:11434`

			`# LLM model to use via Ollama (default: llama3.2)`
			`# OLLAMA_MODEL=llama3.2`

			`# Enable FastAPI interactive docs at /docs and /redoc (default: false)`
			`# DEBUG=true`
feat: integrate AirLLM as optional high-performance backend Adds the `bigbrain` optional dependency group (airllm>=2.9.0) and a complete second inference path that runs 8B / 70B / 405B Llama models locally via layer-by-layer loading — no GPU required, no cloud, fully sovereign. Key changes: - src/timmy/backends.py — TimmyAirLLMAgent (same print_response interface as Agno Agent); auto-selects AirLLMMLX on Apple Silicon, AutoModel (PyTorch) everywhere else - src/timmy/agent.py — _resolve_backend() routing with explicit override, env-config, and 'auto' Apple-Silicon detection - src/timmy/cli.py — --backend / --model-size flags on all commands - src/config.py — timmy_model_backend + airllm_model_size settings - src/timmy/prompts.py — mentions AirLLM "even bigger brains, still fully sovereign" - pyproject.toml — bigbrain optional dep; wheel includes updated - .env.example — TIMMY_MODEL_BACKEND + AIRLLM_MODEL_SIZE docs - tests/conftest.py — stubs 'airllm' module so tests run without GPU - tests/test_backends.py — 13 new tests covering helpers + TimmyAirLLMAgent - tests/test_agent.py — 7 new tests for backend routing - README.md — Big Brain section with one-line install - activate_self_tdd.sh — bootstrap script (venv + install + tests + watchdog + dashboard); --big-brain flag All 61 tests pass. Self-TDD watchdog unaffected. https://claude.ai/code/session_01DMjQ5qMZ8iHeyix1j3GS7c 2026-02-21 16:53:16 +00:00
			`# ── AirLLM / big-brain backend ───────────────────────────────────────────────`
			`# Inference backend: "ollama" (default) \| "airllm" \| "auto"`
			`# "auto" → uses AirLLM on Apple Silicon if installed, otherwise Ollama.`
			`# Requires: pip install ".[bigbrain]"`
			`# TIMMY_MODEL_BACKEND=ollama`

			`# AirLLM model size (default: 70b).`
			`# 8b ~16 GB RAM \| 70b ~140 GB RAM \| 405b ~810 GB RAM`
			`# AIRLLM_MODEL_SIZE=70b`
sec: add startup warnings for default L402 secrets - payment_handler.py: warn when L402_HMAC_SECRET uses default value - l402_proxy.py: warn when L402_MACAROON_SECRET uses default value - .env.example: document L402_HMAC_SECRET, L402_MACAROON_SECRET, and LIGHTNING_BACKEND with generation instructions These warnings ensure operators are alerted before deploying with insecure default secrets. 2026-02-21 13:46:12 -05:00
			`# ── L402 Lightning secrets ───────────────────────────────────────────────────`
			`# HMAC secret for invoice verification. MUST be changed in production.`
			`# Generate with: python3 -c "import secrets; print(secrets.token_hex(32))"`
			`# L402_HMAC_SECRET=<your-secret-here>`

			`# HMAC secret for macaroon signing. MUST be changed in production.`
			`# L402_MACAROON_SECRET=<your-secret-here>`

			`# Lightning backend: "mock" (default) \| "lnd"`
			`# LIGHTNING_BACKEND=mock`
feat: add Telegram bot integration Bridges Telegram messages to Timmy via python-telegram-bot (optional dependency). The bot token can be supplied through the TELEGRAM_TOKEN env var or at runtime via the new POST /telegram/setup dashboard endpoint, which (re)starts the bot without a restart. Changes: - src/telegram_bot/bot.py — TelegramBot singleton: token persistence (telegram_state.json), lifecycle (start/stop), /start command and message handler that forwards to Timmy - src/dashboard/routes/telegram.py — /telegram/setup and /telegram/status FastAPI routes - src/dashboard/app.py — register telegram router; auto-start/stop bot in lifespan hook - src/config.py — TELEGRAM_TOKEN setting (pydantic-settings) - pyproject.toml — [telegram] optional extra (python-telegram-bot>=21), telegram_bot wheel include - .env.example — TELEGRAM_TOKEN section - .gitignore — exclude telegram_state.json (contains token) - tests/conftest.py — stub telegram/telegram.ext for offline test runs - tests/test_telegram_bot.py — 16 tests covering token helpers, lifecycle, and all dashboard routes (370 total, all passing) https://claude.ai/code/session_01CNBm3ZLobtx3Z1YogHq8ZS 2026-02-22 17:16:12 +00:00
			`# ── Telegram bot ──────────────────────────────────────────────────────────────`
			`# Bot token from @BotFather on Telegram.`
			`# Alternatively, configure via the /telegram/setup dashboard endpoint at runtime.`
			`# Requires: pip install ".[telegram]"`
			`# TELEGRAM_TOKEN=`
feat: add Discord integration with chat_bridge abstraction layer Introduces a vendor-agnostic chat platform architecture: - chat_bridge/base.py: ChatPlatform ABC, ChatMessage, ChatThread - chat_bridge/registry.py: PlatformRegistry singleton - chat_bridge/invite_parser.py: QR + Ollama vision invite extraction - chat_bridge/vendors/discord.py: DiscordVendor with native threads Workflow: paste a screenshot of a Discord invite or QR code at POST /discord/join → Timmy extracts the invite automatically. Every Discord conversation gets its own thread, keeping channels clean. Bot responds to @mentions and DMs, routes through Timmy agent. 43 new tests (base classes, registry, invite parser, vendor, routes). https://claude.ai/code/session_01WU4h3cQQiouMwmgYmAgkMM 2026-02-25 01:11:14 +00:00
			`# ── Discord bot ──────────────────────────────────────────────────────────────`
			`# Bot token from https://discord.com/developers/applications`
			`# Alternatively, configure via the /discord/setup dashboard endpoint at runtime.`
			`# Requires: pip install ".[discord]"`
			`# Optional: pip install pyzbar Pillow (for QR code invite detection from screenshots)`
			`# DISCORD_TOKEN=`