EdgeCoder Documentation
This docs site is a consolidated wiki-style view of the full EdgeCoder system. It is built from the repository's README files, operational runbooks, security baseline, and unified plan.
High-Level Summary
What this system does
EdgeCoder provides AI coding workflows that can run locally, on private infrastructure, and across approved distributed worker nodes. It combines coding assistance, orchestration, security controls, and operational governance in one runtime.
Why teams choose it over typical alternatives
- cloud-only tools: often simpler to start, but weaker on private control boundaries
- local-only tools: private by default, but limited when workloads exceed local capacity
- EdgeCoder: local-first with optional coordinator-managed scaling and explicit trust/policy controls
Main benefits
- Privacy + control: keep sensitive work in your environment when required.
- Scalable execution: use mesh capacity for overflow instead of only vertical hardware scaling.
- Operational governance: approvals, blacklist controls, and role-based operations are built in.
- Architecture clarity: separated services (portal/control/coordinator/inference) reduce operational ambiguity.
- Auditability: ledger/stats and issuance flows support stronger integrity verification.
Start Here (Deep Docs)
- System Overview and Benefits
- How EdgeCoder Works
- Architecture Deep Dive
- Request Lifecycle Sequences
- Model Provider Abstraction
- Executor Sandbox and Isolation
- Public Mesh Operations
- Role-based Runbooks
- Agent Mesh Peer-Direct Flow
- Coordinator Discovery and Failover
- Executor Subset Reference
- iOS Power Scheduling
- Stats Ledger Rollout
- Trust and Security
- Threat Model
- Credits, Pricing, and Issuance
- Settlement Lifecycle
- API Surfaces
- API Endpoints Detailed
- Runtime Modes
- Issuance and Economy Parameters
- Coordinator Signing Identity
- Environment Variables
How This Site Is Organized
- Guide
- End-to-end system flow and detailed architecture.
- Operations
- Mesh operations model, deployment topology, and production-oriented workflows.
- Security
- Trust boundaries, identity, supply chain controls, runtime restrictions, and audit posture.
- Economy
- Credits, sats conversion model, payment intents, issuance windows, and ledger guarantees.
- Reference
- API surface map, env variable index, and links to source docs.
Canonical Source Documents
This wiki synthesizes and links to source markdown documents that remain canonical:
- Public Mesh Operations
- Agent and Coordinator Install
- Fly.io Bootstrap
- Security Baseline
- Developer Guide
- Cross-OS Validation
- iOS App Store Release
Product + Design Source of Truth
Design goals and architectural decisions are also documented in: