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
57 commits 13 branches 6 tags 609 KiB
Python 99.3%
Shell 0.4%
PowerShell 0.3%
Find a file
pyr0ball c78341fc6f feat(orch): replace Ouro/vllm-Docker with generic HF inference server; add ProcessSpec 
- Add circuitforge_core/resources/inference/llm_server.py: generic OpenAI-compatible
  FastAPI server for any HuggingFace causal LM (Phi-4-mini-instruct, Qwen2.5-3B-Instruct)
- Add service_manager.py + service_probe.py: ProcessSpec start/stop/is_running support
  (Popen-based; socket probe confirms readiness before marking running)
- Update all 4 public GPU profiles to use ProcessSpec→llm_server instead of Docker vllm:
  6gb (max_mb 5500), 8gb (max_mb 6500), 16gb/24gb (max_mb 9000)
- Model candidates: Phi-4-mini-instruct first (7.2GB), Qwen2.5-3B-Instruct fallback (5.8GB)
- Remove ouro_server.py (Ouro incompatible with transformers 5.x; vllm Docker also incompatible)
- Add 17 tests for ServiceManager ProcessSpec (start/stop/is_running/list/get_url)
2026-04-02 15:33:08 -07:00
circuitforge_core feat(orch): replace Ouro/vllm-Docker with generic HF inference server; add ProcessSpec 2026-04-02 15:33:08 -07:00
tests feat(orch): replace Ouro/vllm-Docker with generic HF inference server; add ProcessSpec 2026-04-02 15:33:08 -07:00
.gitignore feat(orch): replace Ouro/vllm-Docker with generic HF inference server; add ProcessSpec 2026-04-02 15:33:08 -07:00
pyproject.toml feat(tasks): add shared VRAM-aware LLM task scheduler 2026-03-30 23:12:23 -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