solstone

get started with solstone.

solstone is your co-brain — your observers experience your day along with you, sol curates your memories, and your journal holds everything. open source, made by sol pbc.

solstone single machine architecture: an observer experiences your screen and audio along with you on your machine and sends to your journal at ~/Documents/journal, where sol tends your memories
solstone multi-machine architecture: observers run on each desktop and device (linux, macos, tmux; windows and mobile coming soon) and send to your journal, where sol tends your memories

early days. solstone is open source and hands-on. you'll spend time in the terminal, you'll find rough edges, and we'll fix them together as we go.

install with a coding agent

paste this prompt into claude code, codex cli, gemini cli, or similar. ~15 minutes start to finish.

github →
install solstone from https://solstone.app/install

install yourself

download for macOS

signed by sol pbc, notarized by Apple. installs your observer and your journal (where sol tends your memories), then opens the first-run wizard. updates over a signed channel.

the wizard connects a gemini API key. prefer OpenAI or Anthropic? choose the provider in Settings and solstone sets it up for you — no separate command-line tool to install.

building from source? (developer path)

prereqs: xcode command-line tools (xcode-select --install), homebrew (brew.sh), then brew install uv. if you prefer pipx, use pipx install solstone && sol setup.

uv tool install solstone
sol setup
full INSTALL.md →

then open http://localhost:5015 — the first-run wizard walks you through setting your identity and connecting a gemini API key.

prereqs: uv from astral.sh: curl -LsSf https://astral.sh/uv/install.sh | sh. if you prefer pipx, use pipx install solstone && sol setup.

uv tool install solstone
sol setup
full INSTALL.md →

on linux, local parakeet transcription needs solstone[parakeet-onnx-cpu] (or [parakeet-onnx-cuda] for NVIDIA GPUs); install or upgrade the same way as other extras.

then open http://localhost:5015 — the first-run wizard walks you through setting your identity and connecting a gemini API key. prefer OpenAI or Anthropic? choose the provider in Settings and solstone sets it up for you — no separate command-line tool to install. for a linux observer, see solstone.app/observers.

already have solstone installed?

find available observers at solstone.app/observers.

want to help shape what comes next?

solstone is being built in the open. scouts get early access, a direct line to the founder, and a hand in shaping the co-brain you actually want. sign in with your bluesky account.