Skip to content
MicroResolve

Server Install

The MicroResolve server is a single Rust binary (microresolve-studio) with the Studio UI embedded. It exposes a REST API on port 3001 and serves the Studio UI at the same address. Data is stored in a git-tracked directory on disk.

The fastest way to get started is to download the pre-built binary from the GitHub release:

Terminal window
curl -L -o studio.tar.gz https://github.com/gladius/microresolve/releases/download/v0.1.4.1/microresolve-studio-x86_64-unknown-linux-gnu.tar.gz
tar -xzf studio.tar.gz
./microresolve-studio --port 3001 --no-browser --data ./data

Open http://localhost:3001 in your browser — the Studio UI is embedded in the binary, no separate frontend step required.

Prerequisites

  • git on the PATH (used by the data layer for auto-commits and rollback)

Run

Terminal window
# Defaults: port 3001, data at ~/.local/share/microresolve
./microresolve-studio


# Custom data directory
./microresolve-studio --data /var/lib/microresolve


# Custom port
./microresolve-studio --port 8080

Environment variables

VariableDefaultDescription
ANTHROPIC_API_KEY—Required for auto-learn and LLM import
ASV_DATA_DIR~/.local/share/microresolveData directory (overridden by --data flag)

Create a .env file next to the binary and the server reads it on startup:

Terminal window
ANTHROPIC_API_KEY=sk-ant-...

Verify

Terminal window
curl http://localhost:3001/api/health
# {"status":"ok"}


curl http://localhost:3001/api/version
# {"version":"0.1.4.1"}

Studio UI

The Studio UI is served at http://localhost:3001 (the root, not a subpath). Open it in your browser to manage intents, run simulations, and review the auto-learn queue.

See Studio for a full walkthrough.

Data directory layout

~/.local/share/microresolve/
  .git/               ← git repo (auto-created on first run)
  default/            ← "default" namespace
    intents.json
    learned.json
  support/            ← "support" namespace
    intents.json
    learned.json

Every namespace mutation triggers a git commit inside this directory. You can push to a remote with:

Terminal window
curl -X PUT http://localhost:3001/api/settings/git \
  -H "Content-Type: application/json" \
  -d '{"remote_url": "git@github.com:your-org/microresolve-data.git"}'


curl -X POST http://localhost:3001/api/git/push

For contributors: build from source

Building from source requires Rust 1.75+. The Studio UI must be compiled once before the Rust build:

Terminal window
git clone https://github.com/gladius/microresolve
cd microresolve


# Build the embedded UI (one-time)
cd ui && npm run build && cd ..


# Build the server binary
cargo build --release --bin microresolve-studio --features server

The binary lands at ./target/release/microresolve-studio.

Next