Monkey1 🐵

October 21, 2025 · View on GitHub

AI-powered prompt-to-production development platform

Monkey1 transforms natural language into working applications through intelligent multi-agent collaboration. Build, debug, and deploy apps through conversation—no coding required.

What is Monkey1?

Monkey1 is a conversational IDE that combines:

  • 🤖 Multi-Agent AI System: Claude, Gemini, and GPT-5 working together
  • 🔧 Integrated Development Tools: WebContainer sandbox with live preview
  • 🚀 One-Click Deployment: From idea to production in minutes
  • 💬 Mode-Based Interface: Specialized modes for planning, development, debugging, tasks, and deployment

Key Features

  • Natural Language Development: Describe what you want, AI builds it
  • Real-Time Preview: See your application update as you talk
  • Intelligent Debugging: AI agents identify and fix issues automatically
  • Multi-Modal Support: Text, voice, and visual workflows
  • Production Ready: Built-in deployment to Railway, Vercel, and AWS

For Developers

Monkey1 isn't just for beginners—it's a powerful AI-augmented workflow for professional developers:

  • Faster prototyping with AI code generation
  • Intelligent refactoring and optimization suggestions
  • Automated test generation and debugging
  • Natural language git operations and PR management

Railway Deploy Node 22 Yarn 4.9.2 Python 3.13

🏗️ Architecture

packages/
├── backend/           # Python FastAPI (AI processing, core logic)
├── frontend/          # React frontend (UI, dashboard)
├── api-gateway/       # Node.js Express (auth, security, routing)
├── browser-extension/ # Chrome extension (Claude AI integration)
└── shared-types/      # TypeScript shared interfaces

🚀 Quick Start

Prerequisites

  • Node.js 20+
  • Yarn 4.9.2 (via Corepack)
  • Python 3.13+
  • uv 0.8.17+ (for Python backend)
  • Nx

Development Setup

# Enable Corepack and install dependencies
corepack enable
yarn install

# Install Python backend dependencies
npx nx install backend

# Start all services
npx nx run-many -t serve --all

# Or start individual services
npx nx serve api-gateway    # API Gateway on port 3001
npx nx serve frontend        # Frontend on port 3000
npx nx serve backend         # Python backend on port 8000
npx nx storybook ui-components  # Storybook on port 6006

Build Commands (Nx-powered)

# Build all projects
npx nx run-many -t build --all

# Build specific services
npx nx build frontend
npx nx build api-gateway
npx nx build ui-components
npx nx build-storybook ui-components

# Test all projects
npx nx run-many -t test --all

# Typecheck all projects
npx nx run-many -t typecheck --all --parallel=3

📦 Services

Frontend (monkey1-web)

  • Tech: React + Vite + TypeScript
  • Port: 3000 (dev), Railway assigned (prod)
  • Purpose: User interface, dashboard, visualization

API Gateway (monkey1-gateway)

  • Tech: Node.js + Express
  • Port: 8080 (dev), Railway assigned (prod)
  • Purpose: Authentication, rate limiting, request routing

Backend (monkey1-core)

  • Tech: Python + FastAPI + uvicorn
  • Port: 8000 (dev), Railway assigned (prod)
  • Purpose: AI processing, ML models, core business logic

Browser Extension

  • Tech: TypeScript + Vite + Chrome APIs
  • Purpose: Claude AI integration, browser automation

🚀 Deployment

Railway Microservices

The application deploys as 3 separate Railway services:

  1. monkey1-web (256MB) - Frontend static serving
  2. monkey1-gateway (512MB) - API Gateway with security
  3. monkey1-core (1-2GB) - Python AI backend

See docs/deployment/railway/ for detailed deployment guides.

Local Development

# Start all services
yarn dev

# Start individual services (Nx-powered)
yarn dev:web            # Frontend dev server
yarn dev:gateway        # API Gateway dev server
yarn dev:core           # Backend Python server
```## 🛠️ Key Commands

Essential commands for development:

```bash
# View dependency graph
npx nx graph

# Show all projects
npx nx show projects

# Build only affected projects (since last commit)
npx nx affected -t build

# Clear Nx cache
npx nx reset

# View project details
npx nx show project <project-name>

📁 Project Structure

├── packages/                    # Monorepo packages
│   ├── backend/                # Python FastAPI backend (uv managed)
│   ├── frontend/               # React + Vite frontend
│   ├── api-gateway/            # Node.js Express API gateway
│   ├── browser-extension/      # Chrome extension
│   ├── ui-components/          # Shared React components + Storybook
│   ├── design-tokens/          # Design system tokens
│   └── shared-types/           # TypeScript shared types
├── scripts/                    # Development scripts
├── docs/                       # Documentation
│   ├── build-system/           # Nx, Storybook, uv integration
│   ├── deployment/             # Railway deployment guides
│   ├── development/            # Development setup
│   ├── architecture/           # System architecture
│   └── product/                # Product requirements
├── nx.json                     # Nx workspace configuration
├── package.json                # Root workspace configuration
└── README.md                   # This file

🔧 Development

Adding New Features

  1. Frontend: Add to packages/frontend/src/
  2. Backend: Add to packages/backend/
  3. API Gateway: Add to packages/api-gateway/src/
  4. Shared: Add to packages/shared/ for common utilities

Testing

# Run all tests
yarn test

# Test specific service
yarn nx test frontend
yarn nx test backend
yarn nx test api-gateway

Code Quality

# Lint and type check
yarn lint
yarn type-check

# Quality checks
yarn quality

📚 Documentation

Getting Started

Technical Documentation

🤝 Contributing

  1. Follow the monorepo structure
  2. Use shared types from packages/shared-types/
  3. Run yarn quality before committing
  4. Test deployments locally before pushing

📄 License

MIT License - see LICENSE file for details.