autoswarm-shadow-adapter is a zero-core-modification adapter for AutoSwarm that intercepts human-backed agentic tasks, parks them in SQLite WAL, and lets human reviewers or remote compute nodes complete them without engine timeouts. It ships with a React 19 reviewer portal and REST API on port 8800 plus a BYOC shadow-worker daemon for distributed execution.
Project overview
It solves a concrete operational failure mode in agentic workflows — DAGs stalling with engine timeouts when a role needs human sign-off or remote execution — using an external agent registry hook that requires no changes to the AutoSwarm core.
Project type
AI Agent · Workflow
Use cases
Coding & Development · Automation
Deployment
Refer to project documentation
License
MIT
Best for
Developers already running AutoSwarm who need non-blocking human sign-off or remote execution inside agentic DAGs and are comfortable wiring the adapter into their main.py and configuration.
Teams that want to use their own compute — local models via Ollama or their own Anthropic/OpenAI API keys — rather than a required paid service.
Key capabilities
Provides a React 19 UI and REST API (shadow-serve / port 8800) for human reviewers and remote shadow-worker nodes to claim tasks and submit deliverables.
Remote PCs, GPU workstations, and cloud nodes act as silicon employees, running roles on local models such as Ollama or on API keys for Anthropic or OpenAI via shadow-worker.
Limitations and risks
Setup requires editing main.py to register the adapter and start the server thread, and editing company_config.yaml.
Using Anthropic or OpenAI providers sends work to external services; a local Ollama configuration keeps inference local, but the data boundary is external-optional, not local-only by default.
The adapter only functions as an AutoSwarm external agent; it is not a standalone orchestration tool.
No documentation was found covering telemetry or analytics behavior, so teams with data-reporting requirements should verify this before adoption.
Getting started
Install with pip install AutoSwarm-shadow-adapter, register the adapter and call start_server_in_thread(port=8800) in main.py, and set preferred_external_agent: shadow in company_config.yaml. AutoSwarm tasks then route through the adapter.
Evidence and sources
README: pip install AutoSwarm-shadow-adapter
README: You can run the portal server embedded in your main Python process or as a standalone CLI sidecar.
README: It allows AutoSwarm agentic DAGs to pause non-blockingly when a role requires human sign-off (Carbon) or remote GPU execution (Silicon BYOC), without causing engine timeouts or st…
README: Provides a dedicated, secure React 19 UI and REST API (`shadow-serve`) for human reviewers and remote workers (`shadow-worker`).