Emir Karabeg
76dbc4a52f
* feat(db-sync): added general sync file and implemented environment sync * improvement(workflows-store): structured workflows store system better and added getter for values across stores * fix(stores): deleted workflows/types since unused * improvement(db-sync): added workflow event syncs and debounce * improvement(db-sync): clean and upgraded db-sync system; environment sync implemented * improvement(db-sync): added batch sync with registry; init bug needs fixing * improvement(db-sync): finalized sync system and implemented for workflow * fix(db-sync): fixed client-side rendering * improvement(db-sync): created backwards sync system; environment implemented * improvement(db-sync): added colors to db * fix(db-sync): color sync with db * improvement(db-sync): added workflow backwards sync; fixing color bug and race condition * fix(db-stores): color sync * feature(db-sync): db-sync complete; need to sync history * improvement(db-sync): added scheduling * fix(db-sync): environment sync to db
Sim Studio
Sim Studio is a powerful, user-friendly platform that allows developers and agents to build, test, and optimize agentic workflows.
Run
- Self-host
- Join the Waitlist for the cloud-hosted beta
Quick Start
The quickest way to get Sim Studio running locally:
- Clone the repository
git clone https://github.com/simstudioai/sim.git
cd sim
- 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.
- [Optional] Configure Your Environment
In .env, configure Authentication secrets (required for login functionality) and optionally a Resend API key (for authentication emails).
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 start_simstudio_docker.sh
./start_simstudio_docker.sh
Option 2: VS Code / Cursor Dev Containers
For a great development experience with VS Code or Cursor:
-
Install Prerequisites
- Visual Studio Code
- Docker Desktop
- Remote - Containers extension for VS Code
-
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
-
Start Developing
- The container automatically sets up your environment
- Type
sim-startin 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:
- Install dependencies
npm install
- Set up environment variables
Copy .env.example to .env and configure:
- Database connection (PostgreSQL)
- Authentication secret
- Email provider (Resend)
- Set up the database
# Push the database schema
npx drizzle-kit push
- Start the development server
npm run dev
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