Sim Studio is a powerful, user-friendly platform for building, testing, and optimizing agentic workflows.

1. Run on our cloud-hosted version
2. Self-host

There are several ways to self-host Sim Studio:

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

# Create environment file and update with required environment variables (BETTER_AUTH_SECRET)
cp sim/.env.example sim/.env

# Start Sim Studio using the provided script
docker compose up -d --build

or

./start_simstudio_docker.sh

After running these commands:

1. Access the Application:

2. Useful Docker Commands:

   # View application logs
   docker compose logs -f simstudio
   
   # Access PostgreSQL database
   docker compose exec db psql -U postgres -d simstudio
   
   # Stop the environment
   docker compose down
   
   # Rebuild and restart (after code changes)
   docker compose up -d --build

To use local models with Sim Studio, follow these steps:

1. Pull Local Models

   # Run the ollama_docker.sh script to pull the required models
   ./sim/scripts/ollama_docker.sh pull <model_name>

2. Start Sim Studio with Local Models

   #Start Sim Studio with local model support
   ./start_simstudio_docker.sh --local
   
   # or
   
   # Start Sim Studio with local model support if you have nvidia GPU
   docker compose up --profile local-gpu -d --build
   
   # or
   
   # Start Sim Studio with local model support if you don't have nvidia GPU
   docker compose up --profile local-cpu -d --build

The application will now be configured to use your local models. You can access it at http://localhost:3000/w/.

1. Open VS Code or your favorite VS Code fork (Cursor, Windsurf, etc.)
2. Install the Remote - Containers extension
3. Open the project in your editor
4. Click "Reopen in Container" when prompted
5. The environment will automatically be set up in the sim directory
6. Run npm run dev in the terminal or use the sim-start alias

1. Install Dependencies

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

# Install dependencies
npm install

2. Set Up Environment

# Copy .env.example to .env
cp .env.example .env

# Configure your .env file with the required environment variables:
# - Database connection (PostgreSQL)
# - Authentication settings (Better-Auth Secret)

⚠️ Important Notes:

• If RESEND_API_KEY is not set, verification codes for login/signup will be logged to the console.
• You can use these logged codes for testing authentication locally.
• For production environments, you should set up a proper email provider.

3. Set Up Database

# Push the database schema
npx drizzle-kit push

4. Start Development Server

# Start the development server
npm run dev

5. Open http://localhost:3000 in your browser

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

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

Made with ❤️ by the Sim Studio Team