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

The quickest way to get Sim Studio running locally:

1. Clone the repository

git clone https://github.com/simstudioai/sim.git
cd sim

2. Start with Docker

docker compose up -d

Or use the convenience script for automatic setup:

chmod +x start_simstudio_docker.sh
./start_simstudio_docker.sh

This will start Sim Studio at http://localhost:3000 with a local PostgreSQL database.

3. [Optional] Configure Your Environment

Copy .env.example to .env and configure:

• Authentication secrets (required for login functionality)
• API keys:
  • Essential: Resend API key (for authentication emails)
  • Optional: OpenAI, Anthropic, etc. (for specific block functionality)

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