personal memory agent
Refresh README with product-first structure and new screenshots
Restructure README to lead with experience instead of architecture:
- New hero shot of daily dashboard with enriched fixture data
- Transcript viewer screenshot showing speaker-diarized dialogue
- Entity tracking screenshot showing people/companies/projects
- "what you get" section before architecture diagram
- Lowercase headings matching sol pbc brand voice
- Screenshots use fixture data (no real user data)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+37
-37
+37
-37
README.md
+37
-37
README.md
···
2
2
3
3
# solstone
4
4
5
-
Navigate Life Intelligently
5
+
your co-brain — captures everything you see and hear, processes it with AI, and gives you superhuman memory.
6
6
7
-
solstone is an open-source, local-first AI journaling toolkit. It captures screen and audio activity, processes it with AI agents, and presents everything through a searchable web interface. All data stays on your machine in daily journal directories — no cloud, no subscriptions, full ownership.
7
+
solstone runs in the background on your computer, recording audio and screen activity. AI agents transcribe, extract entities, detect meetings, build knowledge graphs, and surface daily insights — all without any manual input. everything stays on your machine in daily journal directories. open source, local-first, no cloud required.
8
8
9
9
Python 3.10+, Linux + macOS, AGPL-3.0-only, maintained by [sol pbc](https://solpbc.org).
10
10
11
11
<img src="docs/static/screenshot-home.png" alt="solstone daily dashboard" width="800">
12
12
13
-
*The daily dashboard with facet tabs, daily goal, todos, upcoming events, and detected entities.*
13
+
*Daily dashboard — goal, todos, upcoming events, and detected entities, all generated from passive capture. Facet tabs organize your life by project or context.*
14
+
15
+
## what you get
16
+
17
+
**a system of intelligence, not just a system of record.**
18
+
19
+
- **automatic transcription** — continuous audio capture with speaker identification. every conversation, transcribed and searchable.
20
+
- **entity tracking** — people, companies, and projects extracted from your conversations and tracked across time.
21
+
- **knowledge graphs** — relationships between entities mapped automatically. who works with whom, which projects connect to which people.
22
+
- **meeting detection** — meetings identified, summarized, and linked. meeting prep that surfaces what you discussed last time and personal context you'd forget.
23
+
- **commitment tracking** — todos captured from natural conversation. no manual entry.
24
+
- **facet organization** — group everything by project or context (work, personal, client-name) with scoped views across all apps.
25
+
- **AI chat** — talk to your journal. ask anything about your digital life and get answers grounded in your actual data.
26
+
- **full-text search** — find anything you've ever seen or heard.
27
+
- **30 AI agents** — configurable workflows for activities, scheduling, research, media analysis, and more. extensible via the agent skill framework.
28
+
- **local-first** — all data in daily journal directories on your filesystem. configurable AI providers (Google Gemini, OpenAI, Anthropic). no cloud dependency.
14
29
15
-
## Architecture
30
+
<img src="docs/static/screenshot-transcripts.png" alt="solstone transcript viewer" width="800">
31
+
32
+
*Transcript viewer — dual-timeline navigation, speaker-diarized dialogue, audio playback, screen capture analysis. every conversation browsable by time.*
33
+
34
+
<img src="docs/static/screenshot-entities.png" alt="solstone entity tracking" width="800">
35
+
36
+
*Entity tracking — people, companies, and projects automatically extracted and tracked across your journal with mention counts and relationship data.*
37
+
38
+
## architecture
16
39
17
40
```text
18
41
+---------+ +----------------+ +---------+
···
36
59
+-------------+
37
60
```
38
61
39
-
- **observe** — Captures audio (PipeWire on Linux, sck-cli on macOS) and screen activity. Produces FLAC audio, WebM screen recordings, and timestamped metadata.
40
-
- **think** — Transcribes audio (faster-whisper), analyzes screen captures, extracts entities, detects meetings, and indexes everything into SQLite. Runs 30 configurable agent/generator templates from `muse/`.
41
-
- **cortex** — Orchestrates agent execution. Receives events, dispatches agents, writes results back to the journal.
42
-
- **callosum** — Async message bus connecting all services. Enables event-driven coordination between observe, think, cortex, and convey.
62
+
- **observe** — captures audio (PipeWire on Linux, sck-cli on macOS) and screen activity. produces FLAC audio, WebM screen recordings, and timestamped metadata.
63
+
- **think** — transcribes audio (faster-whisper), analyzes screen captures, extracts entities, detects meetings, and indexes everything into SQLite. runs 30 configurable agent/generator templates from `muse/`.
64
+
- **cortex** — orchestrates agent execution. receives events, dispatches agents, writes results back to the journal.
65
+
- **callosum** — async message bus connecting all services. enables event-driven coordination between observe, think, cortex, and convey.
43
66
- **convey** — Flask-based web interface with 17 pluggable apps for navigating journal data.
44
-
- **journal** — `JOURNAL_PATH/YYYYMMDD/` daily directories. The single source of truth — transcripts, media, entities, agent outputs, and the SQLite index all live here.
67
+
- **journal** — `JOURNAL_PATH/YYYYMMDD/` daily directories. the single source of truth — transcripts, media, entities, agent outputs, and the SQLite index all live here.
45
68
46
-
## Key Features
47
-
48
-
- **Multimodal capture** — Continuous audio recording with voice activity detection, plus periodic screen capture with AI-powered categorization.
49
-
- **Transcription and speaker identification** — faster-whisper transcription with voice embeddings (resemblyzer) for speaker diarization.
50
-
- **Entity extraction** — People, projects, and concepts extracted from transcripts and tracked across time.
51
-
- **Facet organization** — Group content by project or context (e.g., work, personal, client-name) with scoped views across all apps.
52
-
- **AI agents** — 30 agent configurations for activities, meetings, scheduling, knowledge graphs, research, media analysis, and more. Extensible via the agent skill framework.
53
-
- **Searchable index** — Full-text search across transcripts, entities, and agent outputs via SQLite.
54
-
- **Local-first** — All data in daily journal directories on your filesystem. No cloud dependency. Configurable AI providers (Google Gemini, OpenAI, Anthropic).
55
-
56
-
## Web Interface
57
-
58
-
Convey currently includes 17 discoverable apps for browsing, operating, and maintaining your journal.
59
-
60
-
<img src="docs/static/screenshot-transcripts.png" alt="solstone transcript viewer" width="800">
61
-
62
-
- Daily dashboard, calendar, and scheduling.
63
-
- Transcript browser with dual-timeline navigation.
64
-
- AI chat with configurable providers.
65
-
- Entity tracking, search, and statistics.
66
-
- Speaker identification and management.
67
-
- Health monitoring, token usage, and system settings.
68
-
69
-
## Quick Start
69
+
## quick start
70
70
71
71
```bash
72
72
git clone https://github.com/solpbc/solstone.git
···
102
102
103
103
Run `sol help` for the full command reference.
104
104
105
-
## Documentation
105
+
## documentation
106
106
107
107
| Topic | Document |
108
108
|-------|----------|
···
118
118
| Troubleshooting | [docs/DOCTOR.md](docs/DOCTOR.md) |
119
119
| Project direction | [docs/ROADMAP.md](docs/ROADMAP.md) |
120
120
121
-
## Development
121
+
## development
122
122
123
123
See [AGENTS.md](AGENTS.md) for development guidelines, coding standards, and testing instructions.
124
124
125
125
Use `make dev` to run the full stack against test fixtures, `make ci` for pre-commit checks, and `sol screenshot` for UI testing workflows.
126
126
127
-
## Contributing
127
+
## contributing
128
128
129
129
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution terms.
130
130
131
-
## License
131
+
## license
132
132
133
133
AGPL-3.0-only. See [LICENSE](LICENSE) for details.
134
134
Maintained by [sol pbc](https://solpbc.org).
docs/static/screenshot-entities.png
docs/static/screenshot-entities.png
This is a binary file and will not be displayed.
docs/static/screenshot-home.png
docs/static/screenshot-home.png
This is a binary file and will not be displayed.
docs/static/screenshot-transcripts.png
docs/static/screenshot-transcripts.png
This is a binary file and will not be displayed.