14
14
<strong >Sim Studio</strong > is a lightweight, user-friendly platform for building AI agent workflows.
15
15
</p >
16
16
17
- ## Run
17
+ <p align =" center " >
18
+ <img src =" apps/sim/public/static/demo.gif " alt =" Sim Studio Demo " width =" 800 " />
19
+ </p >
18
20
19
- 1 . Run on our [ cloud-hosted version] ( https://simstudio.ai )
20
- 2 . Self-host
21
+ ## Getting Started
21
22
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
23
25
24
- There are several ways to self-host Sim Studio:
26
+ ## Self-Hosting Options
25
27
26
- ### Option 1: Docker Environment (Recommended )
28
+ ### Option 1: NPM Package (Simplest )
27
29
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 ) :
38
31
39
- or
40
-
41
- ./start_simstudio_docker.sh
32
+ ``` bash
33
+ npx simstudio
42
34
```
43
35
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.
62
37
63
- # Rebuild and restart (after code changes)
64
- docker compose up -d --build
65
- ```
38
+ #### Options
66
39
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
68
42
69
- To use local models with Sim Studio, follow these steps:
43
+ #### Requirements
70
44
71
- 1 . ** Pull Local Models **
45
+ - Docker must be installed and running on your machine
72
46
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
77
48
78
- 2 . ** Start Sim Studio with Local Models**
49
+ ``` bash
50
+ # Clone the repository
51
+ git clone https://github.com/simstudioai/sim.git
79
52
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
83
55
84
- # or
56
+ # Start Sim Studio
57
+ docker compose up -d --build
58
+ ```
85
59
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/ )
88
61
89
- # or
62
+ #### Using Local Models
90
63
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:
94
65
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:
96
67
97
- #### Connecting to Existing Ollama Instance
68
+ ``` bash
69
+ ./apps/sim/scripts/ollama_docker.sh pull < model_name>
70
+ ```
98
71
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 :
100
73
101
74
``` 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
105
77
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
117
80
```
118
81
119
- ### Option 2 : Dev Containers
82
+ ### Option 3 : Dev Containers
120
83
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
127
87
128
- # ## Option 3 : Manual Setup
88
+ ### Option 4 : Manual Setup
129
89
130
- 1. **Install Dependencies**
90
+ 1 . Clone and install dependencies:
131
91
132
92
``` bash
133
- # Clone the repository
134
93
git clone https://github.com/simstudioai/sim.git
135
94
cd sim
136
-
137
- # Install dependencies
138
95
bun install
139
96
```
140
97
141
- 2. ** Set Up Environment**
98
+ 2 . Set up environment:
142
99
143
100
``` bash
144
101
cd 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)
150
103
```
151
104
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:
159
106
160
107
``` bash
161
- # Push the database schema
162
- cd apps/sim
163
108
bunx drizzle-kit push
164
109
```
165
110
166
- 4. ** Start Development Server**
111
+ 4 . Start the development server:
167
112
168
113
``` bash
169
- # Start the development server
170
- cd ../..
171
114
bun run dev
172
115
```
173
116
174
- 5. **Open [http://localhost:3000](http://localhost:3000) in your browser**
175
-
176
117
## Tech Stack
177
118
178
119
- ** Framework** : [ Next.js] ( https://nextjs.org/ ) (App Router)
@@ -193,6 +134,4 @@ We welcome contributions! Please see our [Contributing Guide](.github/CONTRIBUTI
193
134
194
135
This project is licensed under the Apache License 2.0 - see the [ LICENSE] ( LICENSE ) file for details.
195
136
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