feat: PocketVeto v1.0.0 — initial public release

Self-hosted US Congress monitoring platform with AI policy briefs,
bill/member/topic follows, ntfy + RSS + email notifications,
alignment scoring, collections, and draft-letter generator.

Authored by: Jack Levy

.env.example

@@ -0,0 +1,85 @@
+# ─── URLs ─────────────────────────────────────────────────────────────────────
+# Local hostname used when accessing the app on your LAN/server directly
+LOCAL_URL=http://localhost
+# Public-facing URL when accessed via your reverse proxy (leave blank if none)
+PUBLIC_URL=
+
+# ─── Auth ──────────────────────────────────────────────────────────────────────
+# Signs and verifies JWT tokens. Anyone with this key can forge auth tokens,
+# so use a long random value in production and never commit it to git.
+# Generate: python -c "import secrets; print(secrets.token_hex(32))"
+JWT_SECRET_KEY=
+
+# Fernet key for encrypting sensitive user prefs (ntfy passwords, etc.)
+# Generate: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
+# Set once and never change after data has been written.
+ENCRYPTION_SECRET_KEY=
+
+# ─── PostgreSQL ───────────────────────────────────────────────────────────────
+POSTGRES_USER=congress
+POSTGRES_PASSWORD=congress
+POSTGRES_DB=pocketveto
+
+# These are constructed automatically from the above in docker-compose.yml.
+# Override here only if connecting to an external DB.
+# DATABASE_URL=postgresql+asyncpg://congress:congress@postgres:5432/pocketveto
+# SYNC_DATABASE_URL=postgresql://congress:congress@postgres:5432/pocketveto
+
+# ─── Redis ────────────────────────────────────────────────────────────────────
+REDIS_URL=redis://redis:6379/0
+
+# ─── api.data.gov (Congress.gov + GovInfo share the same key) ─────────────────
+# Free key: https://api.data.gov/signup/
+DATA_GOV_API_KEY=
+
+# How often to poll Congress.gov for new/updated bills (minutes)
+CONGRESS_POLL_INTERVAL_MINUTES=30
+
+# ─── LLM Provider ─────────────────────────────────────────────────────────────
+# Choose one: openai | anthropic | gemini | ollama
+LLM_PROVIDER=openai
+
+OPENAI_API_KEY=
+OPENAI_MODEL=gpt-4o-mini
+
+ANTHROPIC_API_KEY=
+ANTHROPIC_MODEL=claude-sonnet-4-6
+
+GEMINI_API_KEY=
+GEMINI_MODEL=gemini-2.0-flash
+
+# For Ollama: use host.docker.internal to reach a locally running Ollama server
+OLLAMA_BASE_URL=http://host.docker.internal:11434
+OLLAMA_MODEL=llama3.1
+
+# Max LLM requests per minute (Celery enforces this globally across all workers).
+# Defaults: Gemini free=15, Anthropic paid=50, OpenAI paid=500.
+# Lower this if you hit rate-limit errors on a restricted tier.
+LLM_RATE_LIMIT_RPM=50
+
+# ─── Google Civic Information API ─────────────────────────────────────────────
+# Used for zip code → representative lookup in the Draft Letter panel.
+# Free tier: 25,000 req/day. Enable the API at:
+# https://console.cloud.google.com/apis/library/civicinfo.googleapis.com
+CIVIC_API_KEY=
+
+# ─── News ─────────────────────────────────────────────────────────────────────
+# Free key (100 req/day): https://newsapi.org/register
+NEWSAPI_KEY=
+
+# ─── Google Trends ────────────────────────────────────────────────────────────
+PYTRENDS_ENABLED=true
+
+# ─── SMTP (Email Notifications) ───────────────────────────────────────────────
+# Leave SMTP_HOST blank to disable email notifications entirely.
+# Supports any standard SMTP server (Gmail, Outlook, Postmark, Mailgun, etc.)
+# Gmail example: HOST=smtp.gmail.com PORT=587 USER=you@gmail.com (use App Password)
+# Postmark example: HOST=smtp.postmarkapp.com PORT=587 USER=<api-token> PASSWORD=<api-token>
+SMTP_HOST=
+SMTP_PORT=587
+SMTP_USER=
+SMTP_PASSWORD=
+# From address shown in the email header — defaults to SMTP_USER if blank
+SMTP_FROM=
+# Set to false only if your SMTP server uses implicit TLS on port 465
+SMTP_STARTTLS=true