Circuit-Forge/circuitforge-core
3
0
Fork 0
Code Issues 6 Pull requests Projects Releases 5 Packages Wiki Activity Actions
Shared scaffold for CircuitForge products
73 commits 13 branches 6 tags 609 KiB
Python 99.3%
Shell 0.4%
PowerShell 0.3%
Find a file
pyr0ball 3deae056de feat: local-first LLM config + hosted coordinator auth 
LLMRouter env-var auto-config:
- No llm.yaml required — auto-configures from ANTHROPIC_API_KEY,
  OPENAI_API_KEY, or OLLAMA_HOST on first use
- Bare-metal self-hosters can run any CF product with just env vars
- Falls back to FileNotFoundError with actionable message only when
  no env vars are set either

CFOrchClient auth:
- Reads CF_LICENSE_KEY env var (or explicit api_key param)
- Sends Authorization: Bearer <key> on all allocation/release requests
- Required for the hosted public coordinator; no-op for local deployments

HeimdallAuthMiddleware (new):
- FastAPI middleware for cf-orch coordinator
- Enabled by HEIMDALL_URL env var; self-hosted deployments skip it
- 5-min TTL cache (matching Kiwi cloud session) keeps Heimdall off the
  per-allocation hot path
- /api/health exempt; free-tier keys rejected with 403 + reason
- 13 tests covering cache TTL, tier ranking, and middleware gating
2026-04-03 08:32:15 -07:00
circuitforge_core feat: local-first LLM config + hosted coordinator auth 2026-04-03 08:32:15 -07:00
tests feat: local-first LLM config + hosted coordinator auth 2026-04-03 08:32:15 -07:00
.gitignore feat(orch): replace Ouro/vllm-Docker with generic HF inference server; add ProcessSpec 2026-04-02 15:33:08 -07:00
CHANGELOG.md chore: CHANGELOG for v0.5.0 2026-04-02 23:05:22 -07:00
pyproject.toml feat: manage.py cross-platform product manager (closes #6) 2026-04-02 23:04:35 -07:00
README.md feat: scaffold circuitforge-core package 2026-03-25 11:02:26 -07:00

README.md

circuitforge-core

Shared scaffold for CircuitForge products.

Modules

  • circuitforge_core.db — SQLite connection factory and migration runner
  • circuitforge_core.llm — LLM router with fallback chain
  • circuitforge_core.tiers — Tier system with BYOK and local vision unlocks
  • circuitforge_core.config — Env validation and .env loader
  • circuitforge_core.vision — Vision router stub (v0.2+)
  • circuitforge_core.wizard — First-run wizard base class stub
  • circuitforge_core.pipeline — Staging queue stub (v0.2+)

Install

pip install -e .

License

BSL 1.1 — see LICENSE