OpenUsage - Self-hosted dashboard for monitoring usage, quotas, balances, and spend across your AI providers and APIs.
Repo ellite/openusage, read from GitHub 24 h ago. ellite has not joined Take My Repo.
ellite/openusage is a public repo on GitHub by ellite. OpenUsage - Self-hosted dashboard for monitoring usage, quotas, balances, and spend across your AI providers and APIs. It declares the GPL-3.0 license on GitHub. It is written mainly in Astro, has 5 stars and last changed on 2026-11-16. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-21.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
A self-hosted dashboard for monitoring usage, quotas, balances, and spend across your AI providers.
Dashboard (dark)

Dashboard (mobile)

Dashboard (mobile, dark)

| Provider | Reported data | Connection method |
|---|---|---|
| Claude | Usage limits, plan, and prepaid-credit balance when available | Browser cURL import |
| Google Gemini | Session and weekly usage limits | Browser cURL import |
| ChatGPT | Plan, subscription status, and Codex usage windows when available | Browser cURL import |
| DeepSeek | Account balance | API key |
| GitHub Copilot | Plan, quota reset date, premium requests, chat, and completions | GitHub device login or token |
| OpenAI | Current-month organization spend, optionally credit balance and subscription details | Admin API key, with optional browser-session import |
| Ollama Cloud | Plan, account balance, free-usage percentage, and reset time | Browser cURL import |
| OpenCode | Go subscription meters, Zen credit balance, and monthly spend | Browser cURL import |
| Mistral | Plan, monthly Vibe allowance, and monthly Studio (API) allowance | API key (Vibe Code or La Plateforme key) |
| Custom API | Any fields you pick from a JSON response, for providers with no dedicated integration | Your own URL/method/headers/body |
Provider integrations that use browser sessions or undocumented endpoints can change as providers update their services. Reconnect the provider if its session expires.
Images are hosted on Docker Hub (
bellamy/openusage). A mirror is also available on GHCR (ghcr.io/ellite/openusage) if you prefer.
curl -o docker-compose.yml https://raw.githubusercontent.com/ellite/openusage/main/docker-compose.yml
docker-compose.yml:# Python
python3 -c "import secrets; print(secrets.token_hex(32))"
# OpenSSL
openssl rand -hex 32
services:
openusage:
image: bellamy/openusage:latest
container_name: openusage
restart: unless-stopped
ports:
- "4188:8000"
environment:
- PUID=1000
- PGID=1000
- TZ=UTC
- ENABLE_ACCOUNT_CREATION=true
- SECRET_KEY=changeme # ← generate with: openssl rand -hex 32
volumes:
- ./data:/app/data
docker compose up -d
docker run -d \
--name openusage \
--restart unless-stopped \
-p 4188:8000 \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=UTC \
-e ENABLE_ACCOUNT_CREATION=true \
-e SECRET_KEY="$(openssl rand -hex 32)" \
-v ./data:/app/data \
bellamy/openusage:latest
ENABLE_ACCOUNT_CREATION=false and restart (docker compose up -d) to close off further registration.docker compose pull && docker compose up -d
The application reads the following environment variables:
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
User ID the container runs as. Match it to the owner of the ./data directory on the host. |
PGID |
1000 |
Group ID the container runs as. |
TZ |
UTC |
IANA timezone name (e.g. America/New_York), applied to the container so logs and timestamps show local time. |
ENABLE_ACCOUNT_CREATION |
true |
Allows new local accounts to be registered. Set to false after creating the accounts you need. |
DB_PATH |
/app/data/openusage.db |
Path to the SQLite database inside the container. |
SECRET_KEY |
change-me-in-production |
Used to encrypt two-factor secrets at rest. Set this to a long random value in production. |
SERVER_URL |
http://localhost:8000 |
Public URL of this instance, used to build password-reset email links. |
SMTP_ADDRESS |
- | SMTP server hostname. Password reset is disabled until this is set. |
SMTP_PORT |
587 |
SMTP server port. |
SMTP_ENCRYPTION |
tls |
tls, ssl, or none. |
SMTP_USERNAME |
- | SMTP username, if the server requires authentication. |
SMTP_PASSWORD |
- | SMTP password. |
FROM_EMAIL |
- | "From" address on password-reset emails. Falls back to SMTP_USERNAME. |
OIDC_ENABLED |
false |
Enables "Sign in with SSO" on the login page. |
OIDC_PROVIDER_NAME |
SSO |
Label shown on the sign-in button. |
OIDC_CLIENT_ID |
- | OAuth2 client ID from your identity provider. |
OIDC_CLIENT_SECRET |
- | OAuth2 client secret. |
OIDC_AUTH_URL |
- | Provider's authorization endpoint. |
OIDC_TOKEN_URL |
- | Provider's token endpoint. |
OIDC_USERINFO_URL |
- | Provider's userinfo endpoint. |
OIDC_REDIRECT_URL |
http://localhost:8000/api/oidc/callback |
Must point at this app's /api/oidc/callback. |
OIDC_IDENTIFIER_FIELD |
email |
Userinfo field used to match/create the local account. |
OIDC_SCOPES |
openid email profile |
OAuth2 scopes requested. |
OIDC_AUTO_CREATE_USERS |
true |
Creates a local account on first SSO login if none matches. |
OIDC_DISABLE_PASSWORD_LOGIN |
false |
Hides the username/password form, making SSO the only way in. |
VAPID_PUBLIC_KEY |
- | Public VAPID key used when browsers subscribe to push notifications. |
VAPID_PRIVATE_KEY |
- | Private VAPID key used to sign push notifications. Keep this secret. |
VAPID_SUBJECT |
mailto:admin@example.com |
Contact URI sent to push services. Use a valid mailto: or HTTPS URI. |
Add any of these to the environment: block in docker-compose.yml, then apply changes with:
docker compose up -d
OpenUsage can send browser push notifications when a service crosses one of its configured usage thresholds. Push notifications remain disabled until the server has a VAPID key pair and a user enables them on a device.
Web Push requires a secure context. Serve OpenUsage over HTTPS in production; browsers generally make an exception only for localhost during local development.
If OpenUsage is already running with Docker Compose, generate a key pair inside the container:
docker exec openusage python /app/scripts/generate_vapid_keys.py
For a native development installation, run the script with the backend virtual environment instead:
cd backend
.venv/bin/python scripts/generate_vapid_keys.py
The script prints a private and public key. Save them in the repository-root .env file, along with a contact address for your server:
VAPID_PRIVATE_KEY=generated-private-key
VAPID_PUBLIC_KEY=generated-public-key
VAPID_SUBJECT=mailto:you@example.com
For Docker Compose, pass those values through the environment section of the openusage service:
environment:
- VAPID_PRIVATE_KEY=${VAPID_PRIVATE_KEY}
- VAPID_PUBLIC_KEY=${VAPID_PUBLIC_KEY}
- VAPID_SUBJECT=${VAPID_SUBJECT}
Then recreate the application container:
docker compose up -d openusage
If you use docker run, pass the same variables with --env-file .env or individual -e options. For a native installation, restart the backend after updating .env.
Keep the private key secret and preserve the same key pair across upgrades and container recreations. Replacing it invalidates existing browser subscriptions, so every device would need to enable notifications again.
Each browser or device must be enabled separately. A notification is sent once when usage crosses a threshold; it is automatically armed again after usage drops below that threshold following a reset.
For Claude, Gemini, and OpenAI session imports, capture a request in your browser's developer tools while signed in to the provider. Paste the complete cURL command into the relevant import field; OpenUsage extracts only the values needed for that integration.
Use a fresh Gemini sign-in in Firefox when importing cookies for unattended use. Recent Chromium-based browsers can create device-bound Google sessions: copied cookies work temporarily, but OpenUsage cannot supply the original browser's device proof to renew them. Repeatedly importing from that same session does not address this limitation. This behavior and the Firefox workaround are also documented by Gemini-API.
OpenUsage attempts cookie renewal during background refreshes and persists issued cookies. A successful HTTP response from Google's RotateCookies endpoint alone does not prove renewal: updates to SIDCC cookies without a new __Secure-1PSIDTS can leave the authentication session expired. The logs distinguish those outcomes. A fresh page token or copying the same cookies into a new headless browser cannot guarantee recovery of a device-bound session.
If a future release changes this behavior, pull it with docker compose pull && docker compose up -d; restarting the existing container alone does not fetch a newer image.
Follow refresh attempts with docker compose logs -f --since 30m openusage | grep 'Gemini refresh'.
Each JSON event includes an attempt ID, service_id, elapsed milliseconds, stage, and outcome.
Stages distinguish cookie rotation, saving credentials, fetching page tokens, and the usage RPC (including retries).
auth_cookie_renewed: true means Google issued a changed __Secure-1PSIDTS. A subsequent persistence / saved event confirms the credentials were saved; fetch / ok confirms usage retrieval.no_auth_cookie_change_reason_unspecified means Google did not supply a changed authentication cookie and did not provide a reason we can identify. It does not prove device binding or expiry by itself.Retry-After, timeout/connection exception type, page redirect category, token presence, and numeric RPC errors identify where a failure occurred. For example, RPC code 7 means permission denied; it does not explain Google's underlying authentication decision.google_di_raw and google_hfcr_raw retain only Google's numeric rotation diagnostic fields. Their meanings are not inferred. Arbitrary response bodies, cookie/token values, and full URLs containing session IDs are excluded.Diagnostics use the existing container logs and remain subject to Docker's configured log retention. No separate credential-bearing debug dump is created.
data/openusage.db.data/openusage.db if you want to retain accounts, provider connections, and cached usage history across host migrations.Browser / PWA
|
v
FastAPI (:8000, single container)
|
+-- Serves the built Astro static site
|
+-- /api/ routes
| |
| +-- SQLite data store
| +-- Provider APIs and browser-session endpoints
StaticFiles./api/ routes and static asset serving, so there is only one container and no internal proxy.The repository is organized as:
backend/ FastAPI application, provider fetchers, and SQLite access
frontend/ Astro application, static build, no server-side runtime
data/ Persistent SQLite data
cp .env.example .env # in the repo root - then edit .env, at minimum set SECRET_KEY
cd backend
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn main:app --reload --host 0.0.0.0 --port 4188
cd frontend
npm install
npm run dev
The frontend dev server starts on http://localhost:4321 and proxies /api/* calls to the backend on port 4188 (override with BACKEND_URL=http://localhost:PORT npm run dev). docker-compose.yml is the production deployment example, not the dev loop — run the backend and frontend natively as above instead.
ellite/openusage is a public repo on GitHub by ellite. OpenUsage - Self-hosted dashboard for monitoring usage, quotas, balances, and spend across your AI providers and APIs.
It declares the GPL-3.0 license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-16. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface
π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.
FastAPI framework, high performance, easy to learn, fast to code, ready for production
:tada: A magical vue admin https://panjiachen.github.io/vue-element-admin
Wallos: Open-source, self-hostable personal subscription tracker. Visualize your recurring expenses, manage your budget, and save money.

Scrob - Self-hosted media tracking app. It syncs your libraries from Jellyfin, Plex, and Emby, tracks your watch history, ratings, and personal lists - Your own private Letterboxd + Trakt

OneDL is a command-line tool to simplify downloading from hosters, torrents, cloud debrid services, and direct HTTP(S) links. It supports Real-Debrid, AllDebrid, Premiumize.me and TorBox, allowing you to resolve direct links from magnets, hoster URLs, MEGA folders, standard HTTP(S) links, or Conntainer files (.torrent and .nzb) and download them.

Candlr - a self-hosted birthday / anniversary calendar and reminder

Anchor: A universal, hardware-accelerated CLI tool for subtitle synchronization (Whisper) and context-aware translation (NLLB)
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/ellite/openusageTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.