eggpool 0.1.0__py3-none-any.whl

eggpool/__init__.py

@@ -0,0 +1,5 @@
+"""EggPool - Python proxy that aggregates OpenCode Go subscriptions."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"

eggpool/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running as `python -m eggpool`."""
+
+from __future__ import annotations
+
+from eggpool.cli import main
+
+main()

eggpool/_share/.env.example

@@ -0,0 +1,9 @@
+# EggPool environment variables
+#
+# API keys are now stored inline in config.toml via the `connect` command.
+# This file is only needed if you use api_key_env (env var) instead of inline keys.
+#
+# Example:
+#   OPENCODE_GO_KEY=sk-your-opencode-go-key
+#
+# See config.example.toml for all available configuration options.

eggpool/_share/config.example.toml

@@ -0,0 +1,551 @@
+[server]
+host = "0.0.0.0"
+port = 11300
+# api_key = "ep_..." # Auto-generated on first `configsetup`; use `eggpool newkey` to regenerate
+log_level = "INFO"
+access_log = true
+
+[upstream]
+base_url = "https://opencode.ai/zen/go/v1"
+connect_timeout_s = 5
+read_timeout_s = 300
+write_timeout_s = 30
+max_connections = 100
+max_keepalive = 20
+keepalive_timeout_s = 30
+
+[database]
+path = "usage.sqlite3"
+busy_timeout_ms = 5000
+wal = true
+synchronous = "NORMAL"
+
+[models]
+# How often to refresh the model catalog from upstream providers (seconds).
+# Also serves as the provider ping interval — each GET /models call measures
+# latency and records health data.
+refresh_interval_s = 300
+expose_mode = "union"
+startup_refresh = true
+stale_after_s = 7200
+allow_stale_catalog = true
+# How many days to retain provider ping data.
+ping_retain_days = 7
+
+[routing]
+strategy = "quota_fair"
+near_tie_epsilon = 0.1
+max_retries_before_stream = 3
+unknown_request_reservation_microdollars = 1000000
+inflight_penalty = 100000
+health_penalty = 500000
+randomize_near_ties = true
+quota_exhausted_cooldown_seconds = 300
+
+[limits]
+five_hour_microdollars = 12000000
+weekly_microdollars = 30000000
+monthly_microdollars = 60000000
+
+[dashboard]
+enabled = true
+public = true
+# Theme name (without .toml extension). "default" uses GitHub Primer colors.
+# Themes are from Halloy: https://themes.halloy.chat/
+# Bundled themes (50+) ship inside the package — no extra files needed.
+# To add custom themes, set themes_dir to a directory of .toml theme files.
+# Custom themes are merged with the bundled set (same-name custom themes
+# take precedence over bundled ones).
+theme = "Cyber Red"
+# themes_dir = "themes"  # Uncomment to add custom themes alongside bundled ones
+retain_request_stats_days = 30
+store_request_content = false
+refresh_interval_s = 60
+
+[security]
+allowed_hosts = []
+cors_origins = []
+redact_headers = ["authorization", "x-api-key"]
+persist_redacted_error_detail = false
+
+# Optional outbound proxies. Omit this section for direct upstream connections.
+# Values use pproxy URI syntax:
+# https://pypi.org/project/pproxy/#uri-syntax
+# Use url_env instead of url when the proxy URI contains credentials.
+# [proxies.residential-us]
+# url = "socks5://127.0.0.1:1080"
+#
+# [proxies.datacenter-eu]
+# url_env = "GOROUTER_DATACENTER_EU_PROXY_URL"
+
+# ─── Provider Accounts ─────────────────────────────────────────────────
+# Use `eggpool connect` to add providers interactively. This is the
+# recommended way to configure accounts — it handles API key storage,
+# config file updates, and server reload automatically.
+#
+# Manual configuration is possible but not recommended. If you prefer
+# editing this file directly, uncomment and customize the examples below.
+# Authenticated providers need an `api_key` (inline) or `api_key_env` (env var
+# name). Providers with `auth.mode = "none"` need neither.
+
+# [providers.opencode-go]
+# id = "opencode-go"
+# base_url = "https://opencode.ai/zen/go/v1"
+# protocols = ["openai", "anthropic"]
+#
+# [[providers.opencode-go.accounts]]
+# name = "personal"
+# api_key = "sk-your-opencode-go-key"
+# # Optional per-key proxy. Omit this field for the default direct connection.
+# # proxy = "residential-us"
+# # proxy_url = "ss://chacha20:password@proxy.example.com:8388"
+# # proxy_url_env = "GOROUTER_PERSONAL_PROXY_URL"
+#
+# [providers.opencode-go.auth]
+# mode = "bearer"
+# header = "Authorization"
+# scheme = "Bearer"
+#
+# # Provider-specific model context limits override upstream metadata.
+# # Use the base model ID (not the provider-suffixed ID).
+# [providers.opencode-go.model_overrides."MiniMax-M3"]
+# max_context_tokens = 220000
+# max_output_tokens = 16384
+# enforce_context_limit = true
+
+# ─── Popular Provider Defaults ─────────────────────────────────────────
+# Uncomment providers you want to use. Each requires an API key from the
+# provider's dashboard. Or use `eggpool connect` for interactive setup.
+
+# DeepSeek — OpenAI compatible, very cost-effective
+# Status: verified (official docs confirm OpenAI + Anthropic compatibility)
+# [providers.deepseek]
+# id = "deepseek"
+# base_url = "https://api.deepseek.com"
+# protocols = ["openai"]
+#
+# [[providers.deepseek.accounts]]
+# name = "default"
+# api_key = "sk-your-deepseek-key"
+#
+# [providers.deepseek.auth]
+# mode = "bearer"
+
+# OpenRouter — 400+ models through one API key
+# Status: verified (official docs confirm OpenAI-compatible endpoint)
+# [providers.openrouter]
+# id = "openrouter"
+# base_url = "https://openrouter.ai/api/v1"
+# protocols = ["openai"]
+#
+# [[providers.openrouter.accounts]]
+# name = "default"
+# api_key = "sk-your-openrouter-key"
+#
+# [providers.openrouter.auth]
+# mode = "bearer"
+#
+# # Optional attribution headers:
+# # [[providers.openrouter.headers]]
+# # name = "HTTP-Referer"
+# # value = "https://example.local"
+# # [[providers.openrouter.headers]]
+# # name = "X-OpenRouter-Title"
+# # value = "EggPool"
+
+# Together AI — popular inference provider
+# Status: verified (official docs confirm OpenAI-compatible endpoint)
+# [providers.together]
+# id = "together"
+# base_url = "https://api.together.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.together.accounts]]
+# name = "default"
+# api_key = "sk-your-together-key"
+#
+# [providers.together.auth]
+# mode = "bearer"
+
+# Fireworks AI — fast inference for open-source models
+# Status: verified (official docs confirm Bearer auth + OpenAI-compatible endpoint)
+# [providers.fireworks]
+# id = "fireworks"
+# base_url = "https://api.fireworks.ai/inference/v1"
+# protocols = ["openai"]
+#
+# [[providers.fireworks.accounts]]
+# name = "default"
+# api_key = "sk-your-fireworks-key"
+#
+# [providers.fireworks.auth]
+# mode = "bearer"
+
+# OpenAI — direct OpenAI API
+# Status: verified — reference OpenAI-compatible provider
+# [providers.openai]
+# id = "openai"
+# base_url = "https://api.openai.com/v1"
+# protocols = ["openai"]
+#
+# [[providers.openai.accounts]]
+# name = "default"
+# api_key = "sk-your-openai-key"
+#
+# [providers.openai.auth]
+# mode = "bearer"
+#
+# # [providers.openai.verify]
+# # probe_model = "gpt-5.5-mini"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# Anthropic — direct Claude API
+# Status: verified — Anthropic Messages API with x-api-key auth and required version header
+# [providers.anthropic]
+# id = "anthropic"
+# base_url = "https://api.anthropic.com/v1"
+# protocols = ["anthropic"]
+# anthropic_path = "/messages"
+#
+# [[providers.anthropic.accounts]]
+# name = "default"
+# api_key = "sk-your-anthropic-key"
+#
+# [providers.anthropic.auth]
+# mode = "api_key"
+# header = "x-api-key"
+#
+# [[providers.anthropic.headers]]
+# name = "anthropic-version"
+# value = "2023-06-01"
+#
+# # [providers.anthropic.verify]
+# # probe_model = "claude-sonnet-4-5"
+# # probe_protocol = "anthropic"
+# # require_models = false
+
+# Groq — low-latency OpenAI-compatible inference
+# Status: verified — official docs use https://api.groq.com/openai/v1 with OpenAI clients
+# [providers.groq]
+# id = "groq"
+# base_url = "https://api.groq.com/openai/v1"
+# protocols = ["openai"]
+#
+# [[providers.groq.accounts]]
+# name = "default"
+# api_key = "sk-your-groq-key"
+#
+# [providers.groq.auth]
+# mode = "bearer"
+#
+# # [providers.groq.verify]
+# # probe_model = "openai/gpt-oss-20b"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# DeepInfra — OpenAI-compatible open-model inference
+# Status: verified — official docs use https://api.deepinfra.com/v1/openai
+# [providers.deepinfra]
+# id = "deepinfra"
+# base_url = "https://api.deepinfra.com/v1/openai"
+# protocols = ["openai"]
+#
+# [[providers.deepinfra.accounts]]
+# name = "default"
+# api_key = "sk-your-deepinfra-key"
+#
+# [providers.deepinfra.auth]
+# mode = "bearer"
+#
+# # [providers.deepinfra.verify]
+# # probe_model = "deepseek-ai/DeepSeek-V3"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# Google Gemini — OpenAI-compatible Gemini API surface
+# Status: verified — official docs use OpenAI clients with Gemini API keys
+# [providers.gemini]
+# id = "gemini"
+# base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
+# protocols = ["openai"]
+#
+# [[providers.gemini.accounts]]
+# name = "default"
+# api_key = "sk-your-gemini-key"
+#
+# [providers.gemini.auth]
+# mode = "bearer"
+#
+# # [providers.gemini.verify]
+# # probe_model = "gemini-3.5-flash"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# xAI — direct Grok API
+# Status: verified — API-key OpenAI client usage with https://api.x.ai/v1
+# [providers.xai]
+# id = "xai"
+# base_url = "https://api.x.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.xai.accounts]]
+# name = "default"
+# api_key = "sk-your-xai-key"
+#
+# [providers.xai.auth]
+# mode = "bearer"
+#
+# # [providers.xai.verify]
+# # probe_model = "grok-4.3"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# Mistral — direct Mistral API
+# Status: verified — /v1/chat/completions with Bearer auth
+# [providers.mistral]
+# id = "mistral"
+# base_url = "https://api.mistral.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.mistral.accounts]]
+# name = "default"
+# api_key = "sk-your-mistral-key"
+#
+# [providers.mistral.auth]
+# mode = "bearer"
+#
+# # [providers.mistral.verify]
+# # probe_model = "mistral-small-latest"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# SiliconFlow — OpenAI-compatible Chinese model aggregator
+# Status: verified — /v1/chat/completions with Bearer auth; verify model listing live
+# [providers.siliconflow]
+# id = "siliconflow"
+# base_url = "https://api.siliconflow.cn/v1"
+# protocols = ["openai"]
+#
+# [[providers.siliconflow.accounts]]
+# name = "default"
+# api_key = "sk-your-siliconflow-key"
+#
+# [providers.siliconflow.auth]
+# mode = "bearer"
+#
+# # [providers.siliconflow.verify]
+# # probe_model = "Pro/zai-org/GLM-4.7"
+# # probe_protocol = "openai"
+# # require_models = true
+
+# Z.AI (ZhipuAI GLM) — OpenAI compatible
+# Status: live-verification-required — confirm base_url and endpoints before production use
+# [providers.zai]
+# id = "zai"
+# base_url = "https://api.z.ai/api/paas/v4"
+# protocols = ["openai"]
+#
+# [[providers.zai.accounts]]
+# name = "default"
+# api_key = "sk-your-zai-key"
+#
+# # Live-verification-required: confirm base_url and endpoints before production use
+# [providers.zai.auth]
+# mode = "bearer"
+
+# Alibaba Qwen — popular Chinese provider
+# Status: verified (official docs confirm OpenAI-compatible endpoint; use regional base_url)
+# [providers.alibaba]
+# id = "alibaba"
+# base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
+# protocols = ["openai"]
+#
+# [[providers.alibaba.accounts]]
+# name = "default"
+# api_key = "sk-your-alibaba-key"
+#
+# [providers.alibaba.auth]
+# mode = "bearer"
+#
+# # Regional alternatives:
+# # US Virginia: https://dashscope-us.aliyuncs.com/compatible-mode/v1
+# # China Beijing: https://dashscope.aliyuncs.com/compatible-mode/v1
+# # Hong Kong: https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1
+
+# Novita AI — various open-source models
+# Status: live-verification-required — confirm base_url and model-list endpoint
+# [providers.novita]
+# id = "novita"
+# base_url = "https://api.novita.ai/openai"
+# protocols = ["openai"]
+#
+# [[providers.novita.accounts]]
+# name = "default"
+# api_key = "sk-your-novita-key"
+#
+# # Live-verification-required: confirm base_url and endpoints before production use
+
+# MiniMax International — OpenAI compatible
+# Status: live-verification-required; use for keys from minimax.io
+# [providers.minimax]
+# id = "minimax"
+# base_url = "https://api.minimax.io/v1"
+# protocols = ["openai"]
+# openai_path = "/chat/completions"
+# models_path = "/models"
+#
+# [[providers.minimax.accounts]]
+# name = "default"
+# api_key = "sk-your-minimax-key"
+#
+# [providers.minimax.auth]
+# mode = "bearer"
+#
+# # Optional live-verification probe — the verifier uses this when neither
+# # --openai-model nor --anthropic-model is supplied.
+# # [providers.minimax.verify]
+# # probe_model = "MiniMax-M2.5"
+# # probe_protocol = "openai"
+
+# MiniMax China — OpenAI compatible
+# Status: live-verification-required; use for keys from the China MiniMax console
+# [providers.minimax-cn]
+# id = "minimax-cn"
+# base_url = "https://api.minimaxi.com/v1"
+# protocols = ["openai"]
+# openai_path = "/chat/completions"
+# models_path = "/models"
+#
+# [[providers.minimax-cn.accounts]]
+# name = "default"
+# api_key = "sk-your-minimax-cn-key"
+#
+# [providers.minimax-cn.auth]
+# mode = "bearer"
+
+# GeneralCompute — OpenAI compatible (uses POST for model listing)
+# Status: unverified — base_url path composition was corrected; run verifier before use
+# [providers.generalcompute]
+# id = "generalcompute"
+# base_url = "https://api.generalcompute.com/v1"
+# protocols = ["openai"]
+# models_method = "POST"
+# models_path = "/models/list"
+#
+# [[providers.generalcompute.accounts]]
+# name = "default"
+# api_key = "sk-your-generalcompute-key"
+#
+# [providers.generalcompute.auth]
+# mode = "bearer"
+
+# NeuralWatt — OpenAI compatible, energy-based pricing
+# Status: live-verification-required — confirm base_url and model-list endpoint
+# [providers.neuralwatt]
+# id = "neuralwatt"
+# base_url = "https://api.neuralwatt.com/v1"
+# protocols = ["openai"]
+#
+# [[providers.neuralwatt.accounts]]
+# name = "default"
+# api_key = "sk-your-neuralwatt-key"
+#
+# # Live-verification-required: confirm base_url and endpoints before production use
+
+# Ollama (local) — OpenAI compatible, no auth required
+# Status: verified (well-known local service)
+# [providers.ollama-local]
+# id = "ollama-local"
+# base_url = "http://localhost:11434/v1"
+# protocols = ["openai"]
+#
+# [[providers.ollama-local.accounts]]
+# name = "default"
+#
+# [providers.ollama-local.auth]
+# mode = "none"
+
+# Ollama (cloud) — OpenAI compatible via /v1 endpoints
+# Status: unverified — confirm base_url and auth before production use
+# [providers.ollama-cloud]
+# id = "ollama-cloud"
+# base_url = "https://ollama.com/v1"
+# protocols = ["openai"]
+#
+# [[providers.ollama-cloud.accounts]]
+# name = "default"
+# api_key = "sk-your-ollama-key"
+#
+# [providers.ollama-cloud.auth]
+# mode = "bearer"
+
+# Cerebras — fast OpenAI-compatible inference
+# Status: live-verification-required — confirm base_url and model listing
+# [providers.cerebras]
+# id = "cerebras"
+# base_url = "https://api.cerebras.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.cerebras.accounts]]
+# name = "default"
+# api_key = "sk-your-cerebras-key"
+
+# SambaNova Cloud — OpenAI-compatible hosted open models
+# Status: live-verification-required — confirm base_url and model listing
+# [providers.sambanova]
+# id = "sambanova"
+# base_url = "https://api.sambanova.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.sambanova.accounts]]
+# name = "default"
+# api_key = "sk-your-sambanova-key"
+
+# Hyperbolic — OpenAI-compatible open-model inference
+# Status: live-verification-required — confirm base_url and model listing
+# [providers.hyperbolic]
+# id = "hyperbolic"
+# base_url = "https://api.hyperbolic.xyz/v1"
+# protocols = ["openai"]
+#
+# [[providers.hyperbolic.accounts]]
+# name = "default"
+# api_key = "sk-your-hyperbolic-key"
+
+# Featherless AI — OpenAI-compatible serverless open-model API
+# Status: live-verification-required — confirm base_url and model listing
+# [providers.featherless]
+# id = "featherless"
+# base_url = "https://api.featherless.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.featherless.accounts]]
+# name = "default"
+# api_key = "sk-your-featherless-key"
+
+# Moonshot AI / Kimi — direct OpenAI-compatible API
+# Status: live-verification-required — confirm base_url and model listing
+# [providers.moonshot]
+# id = "moonshot"
+# base_url = "https://api.moonshot.ai/v1"
+# protocols = ["openai"]
+#
+# [[providers.moonshot.accounts]]
+# name = "default"
+# api_key = "sk-your-moonshot-key"
+
+# Global model overrides apply to all providers. Provider-specific
+# overrides take precedence per field. Token limit fields:
+#   max_context_tokens  - total context window advertised to clients
+#   max_input_tokens    - input ceiling (when different from context)
+#   max_output_tokens   - effective generation ceiling
+#   enforce_context_limit - server-side rejection (default: true)
+# [model_overrides."model-id"]
+# max_context_tokens = 200000
+
+[model_overrides."claude-opus-4"]
+protocol = "anthropic"
+
+[model_overrides."claude-sonnet-4"]
+protocol = "anthropic"

eggpool/accounts/__init__.py

@@ -0,0 +1 @@
+"""Account management and health tracking."""