sim/README.md

Sim Studio

Sim Studio is a powerful, user-friendly platform that allows developers and agents to build, test, and optimize agentic workflows.

Run

1. Self-host
2. Join the Waitlist for the cloud-hosted beta

Quick Start

Try Instantly with npx

Sim Studio now supports a quick start option with zero installation required:

npx sim

This downloads and runs Sim Studio with browser localStorage for data persistence. Visit http://localhost:3000 to start building workflows immediately!

Docker Setup (For Development)

For a full development environment with database support:

# Clone the repository
git clone https://github.com/YOUR_USERNAME/sim.git
cd sim

# Start the Docker environment
./scripts/start_simstudio_docker.sh

VS Code Dev Container

For the best development experience:

1. Install the VS Code Remote - Containers extension
2. Open the project in VS Code
3. Click "Reopen in Container" when prompted
4. Run sim-start in the terminal

Development Options

Option 1: Docker (Recommended)

The quickest way to get started with development:

docker compose up -d

Or use the convenience script for automatic setup:

chmod +x scripts/start_simstudio_docker.sh
./scripts/start_simstudio_docker.sh

Option 2: VS Code / Cursor Dev Containers

For a great development experience with VS Code or Cursor:

1. Install Prerequisites

   • Visual Studio Code
   • Docker Desktop
   • Remote - Containers extension for VS Code

2. Open in Container

   • Open the project in VS Code
   • When prompted, click "Reopen in Container" (or use F1 → "Remote-Containers: Reopen in Container")
   • Wait for the container to build and initialize

3. Start Developing

   • The container automatically sets up your environment
   • Type sim-start in the terminal to run the development server

This method works with GitHub Codespaces too - just click "Code" → "Codespaces" → "Create codespace on main".

Option 3: Manual Setup

If you prefer not to use Docker:

1. Install dependencies

npm install

2. Set up environment variables

Copy .env.example to .env and configure:

• Database connection (PostgreSQL)
• Authentication secret
• Email provider (Resend)

3. Set up the database

# Push the database schema
npx drizzle-kit push

4. Start the development server

npm run dev

5. Open http://localhost:3000

Tech Stack

• Framework: Next.js (App Router)
• Database: PostgreSQL with Drizzle ORM
• Authentication: Better Auth with GitHub OAuth
• UI: Shadcn, Tailwind CSS
• State Management: Zustand
• Flow Editor: ReactFlow

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

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

Made with ❤️ by the Sim Studio Team