get started with solstone.
solstone is the platform, in two parts: sol — the app that lives on your devices, experiences your day with you, and keeps it all in your journal — the memory, on a computer you choose. open source, made by sol pbc.
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.
install solstone from https://solstone.app/install
install yourself
signed by sol pbc, notarized by Apple. sets up sol and your journal on this Mac, 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 it's set 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-journal && pipx install solstone && journal setup.
uv tool install solstone-journal && uv tool install solstone journal setup
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-journal && pipx install solstone && journal setup.
uv tool install solstone-journal && uv tool install solstone journal setup
solstone-journal bundles everything your journal needs to run here — the default CPU transcription runtime is included and journal setup downloads the model. NVIDIA GPU owners who want GPU-accelerated transcription install solstone-journal-cuda instead of solstone-journal (pick one — never both). installing the two tools puts both the journal host and the sol client on your PATH; pip install solstone-journal does the same in one step (sol comes along). want only the thin sol client, to talk to a journal running elsewhere? uv tool install solstone, or uvx solstone for a one-shot.
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 it's set up for you — no separate command-line tool to install. to run sol on your linux desktop, see solstone.app/download.
already have solstone installed?
get sol on more of your devices at solstone.app/download.
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.