Shared scaffold for CircuitForge products
- circuitforge_core.manage module — replaces bash-only manage.sh
- config.py: ManageConfig from manage.toml (TOML via tomllib/tomli)
app name, default_url, docker compose_file/project, native services
Falls back to directory name when no manage.toml present
- docker_mode.py: DockerManager wrapping 'docker compose' (v2 plugin)
or 'docker-compose' (v1 fallback); docker_available() probe
Commands: start, stop, restart, status, logs, build
- native_mode.py: NativeManager with PID file process management
platformdirs for platform-appropriate PID/log paths
Windows-compatible log tailing (polling, no tail -f)
Cross-platform kill: SIGTERM→SIGKILL on Unix, taskkill /F on Windows
- cli.py: typer CLI — start/stop/restart/status/logs/build/open/install-shims
Mode auto-detection: Docker available + compose file → docker; else native
--mode docker|native|auto override
- templates/manage.sh: bash shim (conda, venv, python3 detection)
- templates/manage.ps1: PowerShell shim (same detection, Windows)
- templates/manage.toml.example: annotated config template
- __main__.py: python -m circuitforge_core.manage entry point
- pyproject.toml: manage extras group (platformdirs, typer)
cf-manage console script; version bumped to 0.5.0
- 36 tests: config (6), docker_mode (9), native_mode (21)
|
||
|---|---|---|
| circuitforge_core | ||
| tests | ||
| .gitignore | ||
| CHANGELOG.md | ||
| pyproject.toml | ||
| README.md | ||
circuitforge-core
Shared scaffold for CircuitForge products.
Modules
circuitforge_core.db— SQLite connection factory and migration runnercircuitforge_core.llm— LLM router with fallback chaincircuitforge_core.tiers— Tier system with BYOK and local vision unlockscircuitforge_core.config— Env validation and .env loadercircuitforge_core.vision— Vision router stub (v0.2+)circuitforge_core.wizard— First-run wizard base class stubcircuitforge_core.pipeline— Staging queue stub (v0.2+)
Install
pip install -e .
License
BSL 1.1 — see LICENSE