hanyeol/model-compose
View on GitHub ↗Deploy production-ready AI services in minutes. One YAML file for agents, RAG pipelines, and MCP servers — run anywhere. Inspired by docker-compose.
76 ★4 forksPythonUpdated 19d ago
What you need to know
Declarative AI service composer that deploys chat APIs, RAG pipelines, autonomous agents and MCP servers from a single YAML file.
Install
pip install model-compose uv pip install model-compose
Usage
- •Create model-compose.yml defining controller, workflow and component blocks
- •export OPENAI_API_KEY=your-key && model-compose up
- •Switch an adapter from http-server to mcp-server to expose a workflow as an MCP server
- •Add a runtime block or Redis queue to deploy as a container or scale horizontally
Key features
- ✓One YAML file, any model (HuggingFace, vLLM, llama.cpp, OpenAI, Anthropic, Google, xAI)
- ✓Agents in YAML: ReAct loops, tool use, multi-step reasoning with human-in-the-loop approval
- ✓RAG pipelines with native drivers for Chroma, Milvus, Qdrant, FAISS, Neo4j, ArangoDB and Redis
- ✓MCP server generation with a one-line change; HTTP/WebSocket/MCP protocol adapters
- ✓Stream-native workflows, Gradio web UI, Docker runtime and Redis queue-based horizontal scaling
Best for
Deploying production-ready AI services, including MCP servers, without writing application code.
Caveats
- ⚠Requires model provider credentials (e.g. OPENAI_API_KEY) for hosted models
- ⚠Requires Python 3.10+
Platforms: macOS · Linux · WindowsClients: Claude · ChatGPT · Cursor
Documentation ↗Reviewed 2026-08-11
Topics
agent-frameworkai-agentsai-infrastructureai-workflowanthropicdeclarativehuggingfacelangchain-alternativellmllm-frameworkllm-orchestrationllmopsmcpmcp-servermodel-context-protocolopenairagvector-databaseworkflow-orchestrationyaml
- Stars
- 76★
- Forks
- 4
- Language
- Python
- License
- MIT
- Created
- 2025-05-01
- Last push
- 2026-08-17