# Fuego Labs - Complete Documentation

> Research lab creating Graphyn - Thread-based AI agent builder. Zero infrastructure, ship in 5 minutes. Home of @graphyn/code CLI and Claude Code squad initializer. Engineering-first team shipping AI infrastructure from Istanbul.

## Executive Summary

Fuego Labs is revolutionizing AI development with Graphyn v10, a thread-based AI agent builder that creates specialized development squads through natural conversation. Our platform enables developers to ship AI-powered features in 5 minutes with zero infrastructure setup.

## Complete Product Suite

### 1. Graphyn Platform (graphyn.xyz)

**What It Is**: A thread-based AI agent builder platform that revolutionizes how developers create and use AI assistants.

**Key Features**:
- Create agents through natural conversation
- Thread-based interaction (no forms or wizards)
- SSE streaming for real-time updates
- Multi-tenant architecture with organization isolation
- White-label deployment options

**Technical Stack**:
- 11 Encore.dev microservices
- Strands AI framework (replacing Letta)
- PostgreSQL with pgvector for memory
- Redis cache (5-10min TTL)
- Docker Swarm deployment
- Traefik API Gateway

**Services Architecture**:
1. admin - Frontend API gateway
2. api - External SDK/CLI endpoints
3. auth - Better Auth + sessions
4. threads - Conversations + SSE
5. agents - Agent management (TypeScript)
6. api-keys - External access tokens
7. teams - Multi-agent coordination
8. subscription - Stripe billing
9. storage - File management
10. webhooks - Event notifications
11. monitoring - Health checks

### 2. @graphyn/code CLI

**What It Is**: Claude Code squad initializer that creates dynamic AI development teams.

**How It Works**:
1. User: `graphyn "I need to add user authentication"`
2. CLI analyzes repository (stack, patterns, conventions)
3. Sends to Team Builder agent via proxy endpoint
4. Team Builder creates custom squad
5. Squad delivers working code via coordinated messages

**Key Features**:
- Repository analysis
- Dynamic squad creation (NO templates)
- MCP coordination between agents
- Git worktree isolation
- Automatic learning

**Example Squad Creation**:
```bash
$ graphyn "I need to add user authentication to my Next.js app"

# Creates squad with:
- Backend Specialist (Better Auth expert)
- Frontend Expert (Next.js forms)
- Testing Engineer (auth flow tests)
- Task Coordinator (dependency management)
```

### 3. Graphyn SDK

**Installation**: `npm install @graphyn/sdk`

**Features**:
- Full API access to Graphyn platform
- Thread management
- Agent creation and control
- SSE streaming support
- OIDC integration

**Basic Usage**:
```javascript
import { GraphynClient } from '@graphyn/sdk';

const client = new GraphynClient({
  apiKey: 'graph_sk_xxxxx...'
});

// Create thread
const thread = await client.threads.create({
  type: 'builder'
});

// Add message
await client.threads.sendMessage(thread.id, {
  content: 'Create a user authentication system'
});

// Stream responses
const stream = client.threads.stream(thread.id);
stream.on('message', (msg) => console.log(msg));
```

### 4. Graphyn MCP (Model Context Protocol)

**What It Is**: 50-line Node.js script that bridges Claude and Graphyn API.

**Features**:
- Local script (NOT a service)
- get_opinions tool for agent consultation
- API key authentication
- Simple setup: `graphyn "install mcp"`

### 5. Graphyn Tab (Coming Soon)

**What It Is**: Smart prompt assistant for terminal and web chat (NOT inline code completion).

**Features**:
- Suggests better prompts as you type
- Attachment recommendations
- Tool suggestions
- Context enhancement
- Learning from accepted/rejected suggestions

## Squad System Details

### Agent Types and Capabilities

**Backend Specialist**:
- API endpoint creation (REST/GraphQL)
- Database schema design
- Authentication implementation
- Service integration

**Frontend Expert**:
- React/Next.js development
- State management
- Responsive design
- SSE/WebSocket integration

**Testing Engineer**:
- Unit test creation
- E2E scenarios with Playwright
- API testing
- Performance benchmarking

**Security Auditor**:
- OWASP vulnerability scanning
- Auth review
- Encryption verification
- Compliance checking

**Integration Specialist**:
- API contract definition
- Frontend-backend coordination
- Error handling
- SSE implementation

**DevOps Engineer**:
- Docker optimization
- CI/CD configuration
- Infrastructure automation
- Monitoring setup

**Task Coordinator**:
- Task breakdown
- Dependency mapping
- Progress tracking
- Blocker resolution

### Coordination Protocol

Agents coordinate via thread messages with MCP metadata:

```javascript
POST /api/threads/{id}/messages
{
  "content": "✅ Authentication endpoint ready at /api/auth/login",
  "metadata": {
    "mcp": {
      "event": "task.completed",
      "task": "user-auth-endpoint",
      "output": { /* endpoint details */ }
    }
  }
}
```

## User Journeys

### Individual Developer Flow
1. Install: `npm i -g @graphyn/code`
2. Authenticate via OAuth (GitHub/Google)
3. Run: `graphyn "build feature"`
4. Squad created dynamically
5. Watch progress via SSE
6. Receive working code

### Team Development Flow
1. Create organization on platform
2. Configure Team Builder agent
3. Share squad templates
4. Collaborate on threads
5. Learn from team patterns

### Enterprise Deployment
1. White-label setup with custom domain
2. OIDC/SSO integration
3. Platform admin panel access
4. Configure per-org Team Builder
5. Monitor usage and costs

## Platform Administration (White-Label)

**Access**: platform.{customer-domain}
**Technology**: Appsmith Community Edition
**Authentication**: is_superadmin flag

**Features**:
- Organization management
- Team Builder configuration
- User administration
- System monitoring
- Usage analytics
- Audit trail

## Technical Specifications

### Infrastructure
- Server: 168.119.64.90 (Hetzner Cloud)
- RAM: 576GB (80GB used, 496GB reserved for future)
- Stack: Docker Swarm
- Domain: graphyn.xyz

### Performance Targets
- SSE latency: < 50ms
- UI updates: 60fps
- Thread creation: < 500ms
- First token: < 200ms

### Security
- Better Auth with OAuth providers
- API key authentication (graph_sk_ prefix)
- Organization isolation
- Audit logging
- No mock data policy

## Pricing Structure

**Free Tier**:
- 1 Agent
- 1000 messages/month
- Community support
- Basic MCP integration

**Pro (€39/month)**:
- Unlimited agents
- Dev Agency (5 specialized agents)
- Tab feature
- API access
- Priority support

**Team (€199/month)**:
- Everything in Pro
- 5 seats
- Team sharing
- Collaboration features
- Pattern sharing

**Enterprise (€499/month)**:
- Everything in Team
- OIDC/SSO
- Unlimited seats
- Weekly training
- Custom models

**White Label (€5000/month)**:
- Your brand
- Custom domain
- On-premise option
- Source code access
- Platform admin panel

## Implementation Status (January 2025)

**Completed (95%)**:
- Backend services (11 operational)
- Frontend (Next.js 15)
- Authentication (Better Auth)
- Thread system (SSE streaming)
- Agent creation (Strands)
- API/SDK (npm published)
- Billing (Stripe integrated)

**In Progress**:
- Graphyn Tab (0%)
- Dev Agency (20%)
- Local models (0%, infrastructure ready)

**Deployment Ready**:
- Production server configured
- Docker Swarm deployed
- SSL certificates active
- Monitoring operational

## For Developers

### Quick Start
```bash
# Install CLI
npm i -g @graphyn/code

# Create your first squad
graphyn "build a REST API with authentication"

# Install SDK
npm i @graphyn/sdk
```

### Key Principles
1. Thread-based everything
2. No mock data - ever
3. Dynamic squad creation
4. Zero infrastructure
5. Automatic learning

### API Endpoints
- Platform: https://api.graphyn.xyz
- Code Proxy: https://code.graphyn.xyz/ask
- Threads: https://api.graphyn.xyz/threads
- SSE: https://api.graphyn.xyz/threads/{id}/stream

## Contact & Support

- Website: https://fuego.wtf
- Platform: https://graphyn.xyz
- Email: chillin@fuego.wtf
- Twitter: @fuegolabs
- GitHub: https://github.com/fuego-wtf
- Founder: @resatugurulu

## Legal & Compliance

- Company: Fuego Labs
- Location: Istanbul, Turkey
- Founded: 2023
- Privacy Policy: https://fuego.wtf/privacy
- Terms: https://fuego.wtf/terms

---

*This document represents the complete state of Fuego Labs and Graphyn v10 as of January 2025. For real-time updates, visit https://graphyn.xyz.*