solstone

solstone — the journal

a memory your agents can work from. sol — the app on your devices — experiences your day with you and keeps it all in your journal. your journal is always private, only yours.

this repo is the journal: the memory that holds everything, plus the thin sol access client. it's the python core of the solstone platform — the sol apps on your devices pair with a journal running on a computer you choose. AI agents transcribe, extract entities, detect meetings, build knowledge graphs, and surface daily insights — all without any manual input. everything stays in daily journal directories on your machine. open source, local-first, no cloud required.

Python 3.11+, Linux + macOS, AGPL-3.0-only, maintained by sol pbc.

solstone daily dashboard

Daily dashboard — goal, todos, upcoming events, and detected entities, all generated from observations. Facet tabs organize your life by project or context.

what you get

a system of intelligence, not just storage.

  • automatic transcription — sol hears what you hear and keeps every conversation in your journal, transcribed with speaker identification and searchable.
  • people and projects — extracted from your conversations and remembered across time.
  • knowledge graphs — relationships between entities mapped automatically. who works with whom, which projects connect to which people.
  • meeting detection — meetings identified, summarized, and linked. meeting prep that surfaces what you discussed last time and personal context you'd forget.
  • commitments — todos extracted from natural conversation. no manual entry.
  • facet organization — group everything by project or context (work, personal, client-name) with scoped views across all apps.
  • AI chat — talk to your journal. ask anything about your digital life and get answers grounded in your actual data.
  • full-text search — find anything you've ever seen or heard.
  • 30 AI agents — configurable workflows for activities, scheduling, research, media analysis, and more. extensible via the agent skill framework.
  • local-first — all data in daily journal directories on your filesystem. configurable AI providers (Google Gemini, OpenAI, Anthropic). no cloud dependency.
solstone transcript viewer

Transcript viewer — dual-timeline navigation, speaker-diarized dialogue, audio playback, screen analysis. every conversation browsable by time.

solstone people and projects

People and projects — automatically extracted and remembered across your journal with mention counts and relationship data.

architecture

  +---------+       +----------------+       +---------+
  | observe | ----> |    journal     | ----> |  think  |
  | inputs  |       | YYYYMMDD/ dirs |       | process |
  +---------+       | media, jsonl,  |       | index   |
                    | entities       |       +----+----+
                    +-------+--------+            |
                            ^                     |
                            |  agent outputs      |
                       +----+----+                |
                       | cortex  | <--------------+
                       | agents  |
                       +---------+
                            |
  ==== callosum (event bus) | ==========================
                            |
                     +------+------+
                     |   convey    |
                     | web UI      |
                     +-------------+
  • observe — receives audio and screen observations from standalone observers (solstone-linux, solstone-tmux, solstone-macos) via observer ingest. processes FLAC audio, WebM screen media, and timestamped metadata.
  • think — transcribes audio with Parakeet, analyzes screen observations, surfaces entities, detects meetings, and indexes everything into SQLite. runs 30 configurable agent/generator templates from solstone/talent/.
  • cortex — orchestrates agent execution. receives events, dispatches agents, writes results back to the journal.
  • callosum — async message bus connecting all services. enables event-driven coordination between observe, think, cortex, and convey.
  • convey — Flask-based web interface with 17 pluggable apps for navigating journal data.
  • journal — journal/YYYYMMDD/ daily directories. the single source of truth — transcripts, media, entities, agent outputs, and the SQLite index all live here.

quick start

run a journal here — the full host:

uv tool install solstone-journal && uv tool install solstone
journal setup

pip and pipx equivalents, followed by journal setup:

pip install solstone-journal
pipx install solstone-journal && pipx install solstone

A pip install solstone-journal puts journal and mlx-vlm-server on PATH natively; uv tool and pipx expose each tool's own commands, so the journal install is two commands — the journal tool plus the thin solstone tool. For GPU transcription, install solstone-journal-cuda instead.

want only the thin sol client — to talk to a journal running elsewhere? uv tool install solstone (no extras), or uvx solstone for an ephemeral one-shot.

not sure a computer is up to running the journal? uvx solstone check gives a one-shot readiness verdict — GPU, memory, and disk — before you install anything.

then open http://localhost:5015 in a browser; the first-run wizard sets up your identity and gets sol thinking — locally by default, or on your own provider key if you'd rather use a cloud lane.

see INSTALL.md for prerequisites, observer install, and troubleshooting; see CONTRIBUTING.md if you want to develop on solstone from a source checkout.

CLI

solstone is operated through sol for day-to-day journal access and journal for host operations.

sol                    # Status overview and command list
journal supervisor         # Start the full stack (observe + processing + web)
sol chat               # Interactive AI chat from the terminal
journal transcribe <file>  # Transcribe an audio file
journal indexer            # Rebuild the search index

Run sol help for the full command reference.

documentation

Topic Document
Installation and setup INSTALL.md
Developing from source CONTRIBUTING.md
Journal structure and data model solstone/talent/journal/SKILL.md
Observe pipeline docs/OBSERVE.md
Processing and agents docs/THINK.md
Web interface docs/CONVEY.md
App development docs/APPS.md
Agent runtime docs/CORTEX.md
Message bus docs/CALLOSUM.md
AI provider configuration docs/PROVIDERS.md
What solstone sends to your AI provider DATA-FLOW.md
Troubleshooting docs/DOCTOR.md
Project direction docs/ROADMAP.md

development

See AGENTS.md for development guidelines, coding standards, and testing instructions.

Use make dev to run the full stack against test fixtures, focused test targets during development, and make ci on the final tree before merge or release.

feedback

Questions, feedback, or a bug? Follow and tag @solstone.app on Bluesky for discussion and updates, open an issue at github.com/solpbc/solstone-journal/issues for bugs, or reach support at support.solstone.app. You don't need to know anyone — those are the front doors.

contributing

See CONTRIBUTING.md for contribution terms.

license

AGPL-3.0-only. See LICENSE for details. Bundled third-party model notices: solstone/THIRD_PARTY_NOTICES.md. Maintained by sol pbc.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.22)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for quartzjer from gravatar.com quartzjer

Credits

Author: Jer Miller

License

GNU Affero General Public License v3 (AGPL-3.0-only)

Requires

Python >=3.12

Provides Extra

pdf-import pdf-export pdf journal-host journal journal-cuda

Tags

audio transcription screenshot multimodal ai gemini

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

solstone-0.9.1.tar.gz (5.0 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

solstone-0.9.1-py3-none-macosx_14_0_arm64.whl (5.2 MB view details)

Uploaded Python 3macOS 14.0+ ARM64

solstone-0.9.1-py3-none-any.whl (3.5 MB view details)

Uploaded Python 3

File details

Details for the file solstone-0.9.1.tar.gz.

File metadata

  • Download URL: solstone-0.9.1.tar.gz
  • Upload date:
  • Size: 5.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for solstone-0.9.1.tar.gz
Algorithm Hash digest
SHA256 407bcec9303b4431aea2c2ceb10b1713732fac9ab5f3f5c731492c065c79a579
MD5 0eec9ceb758c5737f23fef20052f9249
BLAKE2b-256 81a37c754ffbceffd680e5545beda5e4a35f259cc167a823ef4fb52fb459edd7

See more details on using hashes here.

File details

Details for the file solstone-0.9.1-py3-none-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for solstone-0.9.1-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 c3ba54f72d2e05e9d2e3f484d31713b138b925b33d6f072a9218e042d54b967e
MD5 a89dbaf8c2d99b2292c803ebd34ced50
BLAKE2b-256 8f3433a0fffcc73d2bcd9082566efb86626a18cc006beb20585fc44b7d49440f

See more details on using hashes here.

File details

Details for the file solstone-0.9.1-py3-none-any.whl.

File metadata

  • Download URL: solstone-0.9.1-py3-none-any.whl
  • Upload date:
  • Size: 3.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for solstone-0.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 58d83f943fbd63fb527a1f966b551372b979bb45b7c3c46835dc432a83e5e218
MD5 ef0fe16956070cadd8c1e0eab4515021
BLAKE2b-256 745769f65486bafbcf7498ee5084767185b2d89b2c7eccca17cd99c1a47a6610

See more details on using hashes here.

Release history Release notifications | RSS feed

1.0.22

3 files

1.0.21

3 files

1.0.20

3 files

1.0.19

3 files

1.0.18

3 files

1.0.17

3 files

1.0.16

3 files

1.0.15

3 files

1.0.13

3 files

1.0.12

3 files

This release

0.9.1 This release

3 files

0.9.0

3 files

0.8.9

3 files

0.8.8

3 files

0.8.7

3 files

0.8.6

3 files

0.8.5

3 files

0.8.4

3 files

0.8.3

3 files

0.8.2

3 files

0.8.1

3 files

0.8.0

3 files

0.7.0

3 files

0.6.24

3 files

0.6.23

3 files

0.6.22

3 files

0.6.21

3 files

0.6.20

3 files

0.6.19

3 files

0.6.18

3 files

0.6.17

3 files

0.6.16

3 files

0.6.15

3 files

0.6.14

3 files

0.6.13

3 files

0.6.12

3 files

0.6.11

3 files

0.6.10

3 files

0.6.9

3 files

0.6.8

3 files

0.6.7

3 files

0.6.5

3 files

0.6.4

3 files

0.6.3

3 files

0.6.2

3 files

0.6.1

3 files

0.6.0

3 files

0.5.6

3 files

0.5.5

3 files

0.5.4

3 files

0.5.3

3 files

0.5.2

3 files

0.5.1

3 files

0.5.0

3 files

0.4.10

3 files

0.4.9

3 files

0.4.8

3 files

0.4.7

3 files

0.4.6

3 files

0.4.5

3 files

0.4.4

3 files

0.4.3

3 files

0.4.2

3 files

0.4.1

3 files

0.4.0

3 files

0.3.9

3 files

0.3.8

3 files

0.3.6

3 files

0.3.5

3 files

0.3.4

3 files

0.3.3

3 files

0.3.2

3 files

0.3.1

3 files

0.3.0

3 files

0.2.1

3 files

0.2.0

3 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page