Initial release - Apache 2.0 - tokenbudget.com

Author: harshagowda

.env.example

@@ -0,0 +1,68 @@
+# ── Environment ────────────────────────────────────────────────────────────
+ENVIRONMENT=development
+# IMPORTANT: Change this to a long random string in production!
+SECRET_KEY=change-me-in-production
+
+# ── Database ────────────────────────────────────────────────────────────────
+DATABASE_URL=postgresql+asyncpg://tokenbudget:localdev@localhost:5432/tokenbudget
+DB_POOL_SIZE=20
+DB_MAX_OVERFLOW=10
+DB_POOL_RECYCLE=3600
+
+# ── Redis ───────────────────────────────────────────────────────────────────
+REDIS_URL=redis://localhost:6379
+
+# ── Signup kill switch ──────────────────────────────────────────────────────
+# Set to false to disable new account/key creation (e.g., maintenance mode)
+SIGNUPS_ENABLED=true
+SIGNUPS_PAUSED_MESSAGE=New signups are temporarily paused. Check back soon.
+
+# ── Free tier limits ────────────────────────────────────────────────────────
+FREE_EVENTS_PER_MONTH=10000
+FREE_KEYS_MAX=3
+FREE_RETENTION_DAYS=30
+FREE_PROJECTS_MAX=3
+
+# ── Pro tier limits ─────────────────────────────────────────────────────────
+PRO_EVENTS_PER_MONTH=500000
+PRO_KEYS_MAX=20
+PRO_RETENTION_DAYS=365
+PRO_PROJECTS_MAX=50
+
+# ── Team tier limits ─────────────────────────────────────────────────────────
+TEAM_EVENTS_PER_MONTH=5000000
+TEAM_KEYS_MAX=100
+TEAM_RETENTION_DAYS=730
+TEAM_PROJECTS_MAX=500
+
+# ── Rate limiting ────────────────────────────────────────────────────────────
+RATE_LIMIT_EVENTS_PER_SECOND=100
+RATE_LIMIT_BURST=200
+
+# ── CORS ─────────────────────────────────────────────────────────────────────
+# JSON array syntax required for pydantic-settings list parsing
+CORS_ORIGINS=["http://localhost:5173","http://localhost:3000"]
+
+# ── Admin ─────────────────────────────────────────────────────────────────────
+# Required for /api/admin/* endpoints. Leave empty to disable.
+ADMIN_KEY=change-this-admin-key
+
+# ── Nightly purge job ─────────────────────────────────────────────────────────
+PURGE_ENABLED=true
+PURGE_BATCH_SIZE=5000
+# Hour and minute (UTC) for the nightly purge cron
+PURGE_CRON_HOUR=3
+PURGE_CRON_MINUTE=0
+
+# ── Clerk Auth (get keys from https://clerk.com) ──────────────────────────────
+# When CLERK_SECRET_KEY is set, the dashboard accepts Clerk session JWTs
+# in addition to the existing tb_ak_ API key flow (which always works).
+# Leave both empty to rely solely on API key auth (the current default).
+CLERK_SECRET_KEY=sk_test_REPLACE_ME
+VITE_CLERK_PUBLISHABLE_KEY=pk_test_REPLACE_ME
+
+# ── Stripe ───────────────────────────────────────────────────────────────────
+STRIPE_SECRET_KEY=
+
+# ── Frontend ──────────────────────────────────────────────────────────────────
+VITE_API_URL=http://localhost:8000

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,19 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+---
+
+**Describe the bug:**
+
+**To Reproduce:**
+
+**Expected behavior:**
+
+**Environment:**
+- OS:
+- Python version:
+- TokenBudget version:
+- Provider: OpenAI / Anthropic / Other
+- Integration method: SDK / Proxy / Direct API
+
+**Logs (if any):**

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,13 @@
+---
+name: Feature Request
+about: Suggest an idea for TokenBudget
+---
+
+**Is your feature request related to a problem?**
+
+**Describe the solution you'd like:**
+
+**Describe alternatives you've considered:**
+
+**Which integration method does this affect?**
+SDK / Proxy / Direct API / Dashboard / All

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-sdk:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - run: cd sdk && pip install -e ".[dev]" && pytest tests/ -v
+
+  test-api:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: tokenbudget_test
+          POSTGRES_USER: tokenbudget
+        ports:
+          - 5432:5432
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
+      redis:
+        image: redis:7-alpine
+        ports:
+          - 6379:6379
+    env:
+      DATABASE_URL: postgresql+asyncpg://tokenbudget:test@localhost:5432/tokenbudget_test
+      REDIS_URL: redis://localhost:6379
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - run: cd api && pip install -e ".[dev]" && pytest tests/ -v
+
+  typecheck-frontend:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: cd frontend && npm ci && npx tsc --noEmit

.gitignore

@@ -0,0 +1,33 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+.pytest_cache/
+node_modules/
+frontend/dist/
+frontend/dist-node/
+frontend/tsconfig.tsbuildinfo
+.env
+.env.local
+*.env
+!*.env.example
+.vscode/
+.idea/
+*.db
+
+# Private planning docs (not for open source)
+MASTER_PROMPT*.md
+TOKENBUDGET_BUSINESS_PLAN_VERIFIED*.md
+TOKENBUDGET_CLAUDE_CODE_PROMPT*.md
+MASTER_PROMPT_FOR_CLAUDE_CODE.md
+ADD_LICENSE.md
+DEVELOPMENT.md
+CONTRIBUTING.md
+DEPLOYMENT.md
+PENDING.md
+PROGRESS.md
+docs/BUSINESS_PLAN.md
+docs/superpowers/
+docs/PUBLIC_LAUNCH_CHECKLIST.md
+.playwright-mcp/

LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026 Harsha Krishne Gowda
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

NOTICE

@@ -0,0 +1,4 @@
+TokenBudget
+Copyright 2026 Harsha Krishne Gowda
+
+Website: https://tokenbudget.com