Fabric Docker

🚀 Fabric Docker

All-in-One Docker deployment for Fabric - AI augmentation framework with Web UI, REST API, and MCP Server

English | Simplified Chinese | Traditional Chinese | Japanese

✨ Features

🚀 Quick Start

# Clone the repository
git clone https://github.com/neosun100/fabric-docker.git
cd fabric-docker

# Copy environment file
cp .env.example .env

# Start with Docker Compose
docker compose up -d

# Access the services
# Web UI:    http://localhost:5173
# REST API:  http://localhost:8180
# Swagger:   http://localhost:8180/swagger/index.html
# MCP:       http://localhost:8181

📦 Installation

Prerequisites

• Docker 20.10+
• Docker Compose 2.0+
• At least one AI provider API key (OpenAI, Anthropic, etc.)

Method 1: Docker Compose (Recommended)

1. Clone the repository

   git clone https://github.com/neosun100/fabric-docker.git
   cd fabric-docker
   

2. Configure environment

   cp .env.example .env
   # Edit .env and add your API keys
   

3. Start services

   docker compose up -d
   

4. Verify deployment

   # Check container health
   docker ps
   
   # Test API
   curl http://localhost:8180/patterns/names
   

Method 2: Docker Run

# Pull or build the image
docker build -t fabric:latest .

# Run the container
docker run -d \
  --name fabric \
  -p 5173:8080 \
  -p 8180:8180 \
  -p 8181:8181 \
  -e OPENAI_API_KEY=your-key-here \
  -e ANTHROPIC_API_KEY=your-key-here \
  -v fabric-config:/root/.config/fabric \
  fabric:latest

⚙️ Configuration

Environment Variables

docker-compose.yml

services:
  fabric:
    build:
      context: .
      dockerfile: Dockerfile
    image: neosun/fabric:latest
    container_name: fabric
    restart: unless-stopped
    ports:
      - "5173:8080"    # Web UI
      - "8180:8180"    # REST API
      - "8181:8181"    # MCP Server
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}
      - DEFAULT_MODEL=gpt-4o
    volumes:
      - fabric-config:/root/.config/fabric
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8180/patterns/names"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  fabric-config:

💻 Usage Examples

Basic Usage

Web UI

Access the web interface at http://localhost:5173:

• Browse and search 233+ patterns
• Execute patterns with custom input
• Manage contexts and sessions
• Real-time chat interface

REST API

# List all patterns
curl http://localhost:8180/patterns/names

# Get a specific pattern
curl http://localhost:8180/patterns/summarize

# Check pattern exists
curl http://localhost:8180/patterns/exists/summarize

# Get available models
curl http://localhost:8180/models/names

# Get configuration
curl http://localhost:8180/config

# Get strategies
curl http://localhost:8180/strategies

API Endpoints

MCP Integration

The MCP server enables AI assistants (like Claude Desktop) to use Fabric patterns directly.

Configure in your MCP client:

{
  "mcpServers": {
    "fabric": {
      "url": "http://localhost:8181"
    }
  }
}

🔧 Technical Details

Architecture

┌─────────────────────────────────────────────────────────┐
│                    Docker Container                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │   Web UI    │  │  REST API   │  │ MCP Server  │     │
│  │   (Node)    │  │   (Go)      │  │  (Python)   │     │
│  │   :8080     │  │   :8180     │  │   :8181     │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
│         │                │                │             │
│         └────────────────┼────────────────┘             │
│                          │                              │
│              ┌───────────┴───────────┐                  │
│              │    Fabric Core        │                  │
│              │  (233+ Patterns)      │                  │
│              └───────────────────────┘                  │
└─────────────────────────────────────────────────────────┘
         │              │              │
    Port 5173      Port 8180      Port 8181

Tech Stack

Project Structure

fabric-docker/
├── Dockerfile              # Multi-stage build
├── docker-compose.yml      # Compose configuration
├── docker/
│   ├── entrypoint.sh      # Container entrypoint
│   ├── supervisord.conf   # Process manager config
│   ├── mcp_server.py      # MCP server implementation
│   └── nginx.conf         # Nginx config (optional)
├── data/
│   ├── patterns/          # 233+ AI patterns
│   └── strategies/        # Prompt strategies
├── web/                   # Svelte Web UI
├── cmd/                   # Go commands
├── internal/              # Go internal packages
└── docs/                  # Documentation

🛠️ Troubleshooting

Container shows "unhealthy"

# Check logs
docker logs fabric

# Restart fabric-api service
docker exec fabric supervisorctl restart fabric-api

# Verify ports
docker exec fabric netstat -tlnp

API not responding

# Check if services are running
docker exec fabric supervisorctl status

# Manual restart
docker compose restart

Port conflicts

Edit .env to change port mappings:

PORT=8280
WEB_PORT=5273
MCP_PORT=8281

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Fabric - The original AI augmentation framework
• Daniel Miessler - Creator of Fabric

⭐ Star History

📱 Follow Me