🔮 Tokeny — AI Cost Dashboard
Open-source dashboard pro sledování nákladů na AI tokeny napříč OpenRouterem, Anthropic Admin API a OpenAI Admin API. CZK & USD, automatický sync, budget alerty, MCP server a AI agent — vše v jednom.
Proč Tokeny?
AI API účty umí nenápadně růst. Tokeny ti ukáže, které modely, provideři, aplikace a klíče stojí peníze — bez posílání dat do dalšího komerčního SaaS. Nahraj CSV, nebo připoj API credential a nech dashboard synchronizovat náklady automaticky.
✨ Features
- 📊 Detailní dashboard — náklady, tokeny, requesty, latence, modely, provideři i app/API-key breakdown
- 🔌 Multi-provider sync — OpenRouter, Anthropic Admin API a OpenAI Admin API v jednom pohledu
- ⏰ Denní auto-sync (Pro) — Vercel Cron spouští sync jednou denně v 05:00 UTC (6:00 SEČ / 7:00 SELČ, tedy po pražské půlnoci; rozpočty a odhad počítají dny a měsíce v pražském čase), s per-credential toggle v UI
- 📁 CSV import — rychlý import OpenRouter exportu přes drag & drop
- 📤 Exporty (Pro) — CSV/JSON podle dne, poskytovatele a modelu, tisknutelný měsíční report (Uložit jako PDF v prohlížeči), snímek PNG
- 🔗 Sdílené odkazy (Pro) — dashboard jen pro čtení na
/s/:token se zvoleným obdobím, poskytovateli a volitelně bez částek; expirace, zrušení, ukládá se jen hash odkazu
- 💱 CZK & USD — automatický kurz z ČNB, přepínání jedním klikem
- 🚨 Rozpočet a odhad (Pro) — měsíční rozpočet v Kč nebo USD (celkem i podle poskytovatele), odhad útraty do konce měsíce s rozpětím a upozornění v aplikaci při 50/80/100 % (kontrola jednou denně, bez e-mailů)
- ☕ Real-life srovnání — kolik káv/piv/pizz odpovídá tvým API nákladům
- 🤖 AI agent — ptej se dashboardu přirozeným jazykem (v obou tarifech, běží na tvém vlastním API klíči Anthropic, OpenAI nebo OpenRouter; žádný sdílený serverový klíč)
- 🔗 MCP server — připoj Claude Desktop, Cursor nebo Zed a ptej se na náklady přímo v chatu
- 🔒 Bezpečné základy — Neon Auth (Better Auth), serverová izolace dat podle uživatele (testovaná), šifrované API klíče
- 📱 Nativní appky (ve vývoji) — iPhone s widgety, Mac menu bar, Apple Watch s komplikací a Zkratky; přihlášení přes Apple nebo e-mail (apple/)
- 🌐 PWA — web jde nainstalovat jako appka na plochu
- 🌐 SEO/AI discoverability — sitemap, robots a
llms.txt
🚀 Live Demo
👉 tokeny.pohl.uk — live demo s ukázkovými daty, bez nutnosti registrace.
☕ Support the project
Tokeny je open-source a free to use. Pokud ti ušetří peníze, čas nebo debugování faktur za AI modely, můžeš vývoj podpořit:
Každé kafe pomáhá platit hosting, testování provider API a další vývoj. 🙏
🍴 Fork & Self-Host
Projekt je open-source — kdokoliv si ho může forknout a rozjet u sebe.
Prerekvizity
- Node.js 20+ / Bun
- Neon projekt (Free plan stačí) se zapnutým Neon Auth
- Vercel projekt (Hobby stačí): web + jedna serverless funkce
api/index.ts
- Volitelně Docker (jen statický frontend)
1. Klasický setup
git clone https://github.com/<your-user>/tokeny-monitor.git
cd tokeny-monitor
bun install
# Schéma do Neonu (idempotentní)
DATABASE_URL='postgresql://…' bun run db:migrate
# Frontend + /api lokálně (Vercel CLI načte env z projektu)
vercel dev
Frontend sám (bun dev, port 8080) běží i bez backendu; přihlášení a data ale potřebují /api.
2. Backend env (Vercel → Settings → Environment Variables)
| Proměnná | Co to je |
|---|
DATABASE_URL | pooled connection string Neon projektu |
NEON_AUTH_BASE_URL | Neon Console → Auth → Auth URL |
NEON_AUTH_COOKIE_SECRET | ≥ 32 náhodných znaků (openssl rand -base64 32) |
CREDENTIALS_ENCRYPTION_KEY | 32 bajtů base64 – šifruje API klíče providerů |
CRON_SECRET | náhodný řetězec; Vercel Cron ho posílá jako Bearer |
APP_URL | např. https://tokeny.martinpohl.cz |
STRIPE_* | volitelné – Pro předplatné (STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_MONTHLY, STRIPE_PRICE_YEARLY, STRIPE_PORTAL_CONFIGURATION (bpc_… Tokeny portal), STRIPE_TRIAL_DAYS) |
V Neon Auth přidej svou doménu do Trusted domains. Kompletní seznam je v .env.example.
3. Docker
docker compose up --build # statický frontend přes nginx na :8080 (API běží na Vercelu)
🏗️ Tech Stack
| Vrstva | Technologie |
|---|
| Frontend | React 18, TypeScript, Vite 5, Tailwind CSS |
| UI | shadcn/ui, Recharts, Framer Motion, lucide-react |
| Data | Neon Postgres (Free), serverová izolace dat v server/repo.ts |
| Backend | Jedna Vercel Function (Hono), Neon Auth (Better Auth), Vercel Cron (denně) |
| Providers | OpenRouter Activity API, Anthropic Admin API, OpenAI Organization Usage/Costs API |
| AI | Anthropic / OpenAI / OpenRouter s klíčem uživatele (BYOK, ai_keys + ai_settings, šifrováno AES-256-GCM, adaptéry v server/ai-providers.ts) |
| Apple | SwiftUI (iOS/macOS/watchOS 26), WidgetKit, App Intents, XcodeGen + Xcode Cloud |
| Web app | PWA |
| Testing | Vitest, Playwright |
| Fonts | Systémové (SF Pro na Apple), Liquid Glass design |
📁 Struktura projektu
├── src/
│ ├── components/dashboard/ # Dashboard widgety, grafy, tabulky, provider connections
│ ├── hooks/ # Auth, currency, dashboard data, export
│ ├── pages/ # Landing, Dashboard, Auth, Settings, Fun, SharedDashboard, Report
│ ├── lib/ # CSV parser, formátování, utility
│ └── lib/api.ts, auth-client.ts # same-origin /api klient a Neon Auth klient
├── api/index.ts # jediná Vercel Function (Hono app ze server/)
├── server/ # API routy, Neon Auth proxy, MCP, sync, Stripe, cron
├── db/schema.sql # schéma pro Neon (idempotentní)
├── apple/ # Nativní appky: iPhone + widgety, Mac menu bar, Watch (XcodeGen, Xcode Cloud)
├── public/ # PWA assets, SEO, robots, sitemap, llms.txt
├── marketing/ # Launch copy, blog drafts, screenshots, plan
├── Dockerfile # Multi-stage build
├── docker-compose.yml # One-command spuštění
└── .env.example # Šablona env proměnných
🧭 Changelog
Unreleased / recent
- Backend přepsaný ze Supabase na Neon (Postgres + Neon Auth) a jednu Vercel Function pod
/api/*. Nativní appky mluví jen s webovou doménou.
- Added daily auto-sync for connected provider credentials via Supabase
pg_cron and new auto-sync Edge Function.
- Added per-credential Auto-sync denně toggle and next-run hint in Provider Connections UI.
- Improved OpenRouter sync to support per-user credentials while keeping legacy global-key fallback.
- Auto-sync now processes OpenRouter, Anthropic and OpenAI credentials and updates sync status, errors and imported row counts.
- Added budget-check pass after scheduled syncs.
2026-05-10
- Added multi-provider support: Anthropic Admin API and OpenAI Admin API alongside OpenRouter.
- Added
provider_credentials storage with RLS/column protection and dedicated sync Edge Functions.
- Updated dashboard aggregation so OpenAI/Anthropic daily buckets count
request_count correctly.
- Migrated AI/email flows away from Lovable dependencies to Anthropic API + Resend.
- Added marketing plan page and marketing kit content.
- Added SEO/AI crawler assets: sitemap, robots updates and
llms.txt.
🤝 Contributing
- Forkni repo
- Vytvoř feature branch (
git checkout -b feature/cool-thing)
- Commitni změny (
git commit -m 'Add cool thing')
- Pushni branch (
git push origin feature/cool-thing)
- Otevři Pull Request
Před PR prosím spusť:
bun run lint
bun run typecheck
bun run test
bun run build
(cd apple/TokenyKit && swift test) # pokud měníš nativní kód
📄 License
MIT — dělej si s tím co chceš. Pokud ti to pomáhá, kup mi kafe ☕.
