Install SystemPrompt from the template repository.
Requires: Rust 1.75+, Git, PostgreSQL
Prerequisites
Verify required tools:
rustc --version # 1.75.0+
git --version
gh --version # Optional but recommended
PostgreSQL is the only external dependency. Any PostgreSQL 15+ works.
Clone Template
Option A: GitHub CLI (Recommended)
gh repo create my-ai --template systempromptio/systemprompt-template --clone --private
cd my-ai
git submodule update --init --recursive
Option B: Manual Clone
git clone --recursive https://github.com/systempromptio/systemprompt-template.git my-ai
cd my-ai
Build Binary
SQLX_OFFLINE=true cargo build --release -p systemprompt-cli
The SQLX_OFFLINE=true flag is required for first build (no database yet).
Login
IMPORTANT: Manual command only. Do not run via agents.
systemprompt cloud auth login
This opens a browser for GitHub or Google OAuth. Registration is:
- Free — No payment required
- Required — License grant depends on authentication
- One-time — Credentials persist in
.systemprompt/credentials.json
Create Tenant
Local development:
systemprompt cloud tenant create --type local
You will be prompted for DATABASE_URL. Example formats:
| Host | DATABASE_URL |
|---|---|
| Local | postgres://user:pass@localhost:5432/systemprompt |
| Docker | postgres://postgres:postgres@localhost:5432/systemprompt |
| Neon | postgres://user:pass@ep-xxx.us-east-2.aws.neon.tech/systemprompt |
| Supabase | postgres://postgres:pass@db.xxx.supabase.co:5432/postgres |
Cloud (managed PostgreSQL):
systemprompt cloud tenant create --region iad
Create Profile
systemprompt cloud profile create local
This creates .systemprompt/profiles/local/profile.yaml with your configuration.
Run Migrations
systemprompt infra db migrate
Start Services
just start
Or via CLI:
systemprompt infra services start --all
Verify Installation
systemprompt infra services status
systemprompt infra db status
systemprompt admin agents list
Visit http://localhost:8080 to see the homepage.
Troubleshooting
| Issue | Solution |
|---|---|
| Build fails on macOS | Install OpenSSL: brew install openssl |
| Database connection refused | Verify PostgreSQL is running, check DATABASE_URL |
| Login fails | Ensure browser access, check network |
| Migrations fail | Check DATABASE_URL format, verify database exists |
Quick Reference
| Task | Command |
|---|---|
| Build | SQLX_OFFLINE=true cargo build --release -p systemprompt-cli |
| Login | systemprompt cloud auth login (manual only) |
| Create local tenant | systemprompt cloud tenant create --type local |
| Create cloud tenant | systemprompt cloud tenant create --region iad |
| Create profile | systemprompt cloud profile create <name> |
| Run migrations | systemprompt infra db migrate |
| Start services | systemprompt infra services start --all |
| Check status | systemprompt infra services status |