Gemini Pool

Pool multiple Google accounts for free Gemini API access. Each account adds 20 requests per day (RPD). Connect 5 accounts and you get 100 RPD at zero cost.

How It Works

1. You connect a Google account via OAuth.
2. ɳSelf creates a GCP project, enables the Gemini API, and generates a restricted API key.
3. The key is AES-256 encrypted with a per-install Data Encryption Key (DEK) and stored in PostgreSQL.
4. The routing engine spreads requests across all connected accounts, respecting daily limits.
5. When an account hits its limit, it is marked exhausted and skipped until the daily reset.

Adding Accounts

# Interactive (opens browser for OAuth)
nself ai pool add

# Check pool status
nself ai pool status

# List connected accounts
nself ai pool list

The OAuth flow takes about 15 seconds. You never see or handle the API key directly.

Pool Management

# Test all accounts
nself ai pool test

# Test a specific account
nself ai pool test --account user@gmail.com

# Rotate an API key (creates new key, deletes old one)
nself ai pool rotate --account user@gmail.com

# Remove an account from the pool
nself ai pool remove --account user@gmail.com

Capacity Planning

Combined with unlimited local inference, most personal and small-team workloads never need a paid API key.

Account Statuses

• Active — Working, has remaining RPD.
• Rate Limited — Temporary Google rate limit (usually clears in minutes).
• Exhausted — Daily limit reached. Resets at midnight Pacific.
• Revoked — API key was revoked in GCP console. Rotate to fix.
• Error — Network or auth error. Check logs.

Audit Log

# View recent pool activity
nself ai pool audit

# View audit for a specific account
nself ai pool audit --account user@gmail.com

Every pool operation (add, remove, rotate, test, request) is logged with timestamp, account, and result.