DOCUMENTATION
Understanding Spec4AI Studio
Conceptual overview of the Spec4AI Studio architecture, components, and trust model. Full API docs coming at launch.
Three-layer architecture
Spec-driven applets: JSON specs, assets, capability manifests, tests
40+ tools across 8 namespaces: app, ui, hardware, storage, package, model, debug, control
Flutter container, MCP server, permission engine, lease manager, receipt log
Core concepts
Applet
A self-contained app: JSON spec + assets + capability manifest + optional tests. Applets run in the Spec4AI Studio runtime with explicit, scoped permissions.
Capability Manifest
Every applet declares what it needs: network access, camera, storage, etc. The manifest is reviewed before installation via a permission card.
Permission Card
A human-readable summary of what an applet can do. Presented before installation. No hidden permissions — what you see is what it gets.
Lease
Time-limited access tokens for sensitive capabilities. Leases expire automatically. No permanent grants to sensitive hardware or data.
Receipt
An auditable record of every tool call an applet makes. Receipts include what was accessed, when, the result, and the requesting applet.
Channel
A distribution feed from a registered publisher. Subscribe to get applet updates. Like RSS for applets.
Evidence Bundle
Generated at deploy time: the spec, screenshots, test results, and capability manifest. Evidence is how trust is established.
Builder
The desktop component that generates, tests, and deploys applets. Runs locally (Claude Desktop or any MCP client). Never required at runtime.
API SURFACE
Tool namespaces
Spec4AI Studio exposes 40+ tools organized into 8 namespaces.
SECURITY
Security model
- Sandboxed runtime — applets can only access declared capabilities
- Time-limited leases for sensitive access
- Receipt log for full auditability
- Publisher registration with public key cryptography
- Runner Safe Mode blocks unregistered publishers
- No telemetry by default — reporting is opt-in and minimal
GUIDES
Guides & references
Getting Started
Your first 10 minutes with SPEC4AI Studio. Install, connect, and run your first commands.
Read guide →User Guide
Complete user manual: installation, pairing, chat modes, micro-apps, Founder Pack, settings, Claude Desktop integration, and troubleshooting.
Read guide →Features & Functions
Complete overview of 40+ tools, prebuilt applets, on-device AI, and hardware control.
Read guide →Docker MCP — Safe AI Tool Execution
Run filesystem, terminal, and development tools safely inside Docker containers via MCP.
Read guide →Docker Database Services — PostgreSQL + REST API
Deploy PostgreSQL and PostgREST in Docker for per-app relational databases with automatic REST API. Includes Claude Code helper prompt.
Read guide →Setup & Downloads
Download SPEC4AI Link for macOS, Linux, or Windows. Platform-specific install instructions.
Read guide →Want to dive deeper?
Full API documentation and integration guides will be available at launch.