1414 <strong >Sim Studio</strong > is a lightweight, user-friendly platform for building AI agent workflows.
1515</p >
1616
17- ## Run
17+ <p align =" center " >
18+ <img src =" apps/sim/public/static/demo.gif " alt =" Sim Studio Demo " width =" 800 " />
19+ </p >
1820
19- 1 . Run on our [ cloud-hosted version] ( https://simstudio.ai )
20- 2 . Self-host
21+ ## Getting Started
2122
22- ## How to Self-Host
23+ 1 . Use our [ cloud-hosted version] ( https://simstudio.ai )
24+ 2 . Self-host using one of the methods below
2325
24- There are several ways to self-host Sim Studio:
26+ ## Self-Hosting Options
2527
26- ### Option 1: Docker Environment (Recommended )
28+ ### Option 1: NPM Package (Simplest )
2729
28- ``` bash
29- # Clone the repository
30- git clone https://github.com/simstudioai/sim.git
31-
32- # Create environment file and update with required environment variables (BETTER_AUTH_SECRET)
33- cd apps/sim
34- cp .env.example .env
35-
36- # Start Sim Studio using the provided script
37- docker compose up -d --build
30+ The easiest way to run Sim Studio locally is using our [ NPM package] ( https://www.npmjs.com/package/simstudio?activeTab=readme ) :
3831
39- or
40-
41- ./start_simstudio_docker.sh
32+ ``` bash
33+ npx simstudio
4234```
4335
44- After running these commands:
45-
46- 1 . ** Access the Application** :
47-
48- - Open [ http://localhost:3000/w/ ] ( http://localhost:3000/w/ ) in your browser
49- - The ` /w/ ` path is where the main workspace interface is located
50-
51- 2 . ** Useful Docker Commands** :
52-
53- ``` bash
54- # View application logs
55- docker compose logs -f simstudio
56-
57- # Access PostgreSQL database
58- docker compose exec db psql -U postgres -d simstudio
59-
60- # Stop the environment
61- docker compose down
36+ After running these commands, open [ http://localhost:3000/ ] ( http://localhost:3000/ ) in your browser.
6237
63- # Rebuild and restart (after code changes)
64- docker compose up -d --build
65- ```
38+ #### Options
6639
67- #### Working with Local Models
40+ - ` -p, --port <port> ` : Specify the port to run Sim Studio on (default: 3000)
41+ - ` --no-pull ` : Skip pulling the latest Docker images
6842
69- To use local models with Sim Studio, follow these steps:
43+ #### Requirements
7044
71- 1 . ** Pull Local Models **
45+ - Docker must be installed and running on your machine
7246
73- ``` bash
74- # Run the ollama_docker.sh script to pull the required models
75- ./apps/sim/scripts/ollama_docker.sh pull < model_name>
76- ```
47+ ### Option 2: Docker Compose
7748
78- 2 . ** Start Sim Studio with Local Models**
49+ ``` bash
50+ # Clone the repository
51+ git clone https://github.com/simstudioai/sim.git
7952
80- ``` bash
81- # Start Sim Studio with local model support
82- ./start_simstudio_docker.sh --local
53+ # Navigate to the project directory
54+ cd sim
8355
84- # or
56+ # Start Sim Studio
57+ docker compose up -d --build
58+ ```
8559
86- # Start Sim Studio with local model support if you have nvidia GPU
87- docker compose up --profile local-gpu -d --build
60+ Access the application at [ http://localhost:3000/ ] ( http://localhost:3000/ )
8861
89- # or
62+ #### Using Local Models
9063
91- # Start Sim Studio with local model support if you don't have nvidia GPU
92- docker compose up --profile local-cpu -d --build
93- ```
64+ To use local models with Sim Studio:
9465
95- The application will now be configured to use your local models. You can access it at [ http://localhost:3000/w/ ] ( http://localhost:3000/w/ ) .
66+ 1 . Pull models using our helper script:
9667
97- #### Connecting to Existing Ollama Instance
68+ ``` bash
69+ ./apps/sim/scripts/ollama_docker.sh pull < model_name>
70+ ```
9871
99- If you already have an Ollama instance running on your host machine, you can connect to it using one of these methods :
72+ 2 . Start Sim Studio with local model support :
10073
10174``` bash
102- # Method 1: Use host networking (simplest approach)
103- docker compose up --profile local-cpu -d --build --network=host
104- ```
75+ # With NVIDIA GPU support
76+ docker compose up --profile local-gpu -d --build
10577
106- Or modify your docker-compose.yml:
107-
108- ``` yaml
109- # Method 2: Add host.docker.internal mapping
110- services :
111- simstudio :
112- # ... existing configuration ...
113- extra_hosts :
114- - ' host.docker.internal:host-gateway'
115- environment :
116- - OLLAMA_HOST=http://host.docker.internal:11434
78+ # Without GPU (CPU only)
79+ docker compose up --profile local-cpu -d --build
11780```
11881
119- ### Option 2 : Dev Containers
82+ ### Option 3 : Dev Containers
12083
121- 1. Open VS Code or your favorite VS Code fork (Cursor, Windsurf, etc.)
122- 2. Install the [Remote - Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
123- 3. Open the project in your editor
124- 4. Click "Reopen in Container" when prompted
125- 5. The environment will automatically be set up
126- 6. Run ` bun run dev` in the terminal or use the `sim-start` alias
84+ 1 . Open VS Code with the [ Remote - Containers extension] ( https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers )
85+ 2 . Open the project and click "Reopen in Container" when prompted
86+ 3 . Run ` bun run dev ` in the terminal or use the ` sim-start ` alias
12787
128- # ## Option 3 : Manual Setup
88+ ### Option 4 : Manual Setup
12989
130- 1. **Install Dependencies**
90+ 1 . Clone and install dependencies:
13191
13292``` bash
133- # Clone the repository
13493git clone https://github.com/simstudioai/sim.git
13594cd sim
136-
137- # Install dependencies
13895bun install
13996```
14097
141- 2. ** Set Up Environment**
98+ 2 . Set up environment:
14299
143100``` bash
144101cd apps/sim
145- cp .env.example .env # or create a new .env file
146-
147- # Configure your .env file with the required environment variables:
148- # - Database connection (PostgreSQL)
149- # - Authentication settings (Better-Auth Secret, Better-Auth URL)
102+ cp .env.example .env # Configure with required variables (DATABASE_URL, BETTER_AUTH_SECRET, BETTER_AUTH_URL)
150103```
151104
152- ⚠️ **Important Notes:**
153-
154- - If `RESEND_API_KEY` is not set, verification codes for login/signup will be logged to the console.
155- - You can use these logged codes for testing authentication locally.
156- - For production environments, you should set up a proper email provider.
157-
158- 3. **Set Up Database**
105+ 3 . Set up the database:
159106
160107``` bash
161- # Push the database schema
162- cd apps/sim
163108bunx drizzle-kit push
164109```
165110
166- 4. ** Start Development Server**
111+ 4 . Start the development server:
167112
168113``` bash
169- # Start the development server
170- cd ../..
171114bun run dev
172115```
173116
174- 5. **Open [http://localhost:3000](http://localhost:3000) in your browser**
175-
176117## Tech Stack
177118
178119- ** Framework** : [ Next.js] ( https://nextjs.org/ ) (App Router)
@@ -193,6 +134,4 @@ We welcome contributions! Please see our [Contributing Guide](.github/CONTRIBUTI
193134
194135This project is licensed under the Apache License 2.0 - see the [ LICENSE] ( LICENSE ) file for details.
195136
196- # #
197-
198- <p align="center">Made with ❤️ by the Sim Studio Team</p>
137+ <p align =" center " >Made with ❤️ by the Sim Studio Team</p >
0 commit comments