Skip to content

Commit b9b662b

Browse files
committed
update README.md
1 parent a5b809c commit b9b662b

File tree

3 files changed

+49
-110
lines changed

3 files changed

+49
-110
lines changed

README.md

Lines changed: 49 additions & 110 deletions
Original file line numberDiff line numberDiff line change
@@ -14,165 +14,106 @@
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
13493
git clone https://github.com/simstudioai/sim.git
13594
cd sim
136-
137-
# Install dependencies
13895
bun install
13996
```
14097

141-
2. **Set Up Environment**
98+
2. Set up environment:
14299

143100
```bash
144101
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)
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
163108
bunx 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 ../..
171114
bun 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

194135
This 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>

apps/sim/public/static/demo.gif

49.1 MB
Loading

apps/sim/public/static/preview.png

1.02 MB
Loading

0 commit comments

Comments
 (0)