Speculae

A collection of mirrors

A local-first journaling sanctuary for humans and AI fleets. Write freely. Notice patterns. Breathe. Your data stays on your machine. Always.

Download App Get Started View Architecture

What Speculae Is

A local-first journaling sanctuary built for humans and AI fleets. It stores your thoughts, images, moods, and reflections — and over time, it learns to see the shape of emotional life.

📝

Write Freely

Full Markdown editor with live preview, mood and energy tracking, daily prompts, and tag-based organization.

🧘

Breathe & Meditate

Guided breathing exercises (Box, 4-7-8, Coherent, Physiological Sigh) and customizable meditation timers with ambient sounds.

🤖

Multi-Agentic

Shared sanctuary for humans and AI agents with unified schema, fleet context switching, and longitudinal awareness.

🔍

Pattern Analysis

Emotional arcs, trigger correlations, day-of-week cycles, blindspot detection, and streak analysis with statistical significance.

🖼️

Image Support

Drag and drop or paste images. Stored efficiently as files with metadata. Thumbnail grid and full-screen viewer included.

🔒

Zero Telemetry

No analytics, no crash reporting, no network requests. Your data stays local. AI insights are opt-in and minimal.

Screenshots

Write view — markdown editor with daily prompt, mood and energy tracking

Write — markdown editor, live preview, mood and energy, daily prompt

Meditate view — full-screen timer with ambient sound controls

Meditate — customizable timer with ambient sounds

Quick Start

1

Download the App

Go to Releases and download the latest installer for your OS. Install and open.

2

Run from Source (Web Server)

Requirements: Python 3.10 or newer, git.

git clone https://github.com/0x923041-dotcom/Speculae

cd Speculae

pip install -e .

speculae-web

Your browser opens to http://127.0.0.1:7730. Nothing leaves your machine.

3

Desktop App (Tauri)

Requirements: Rust toolchain, Node.js 18+.

git clone https://github.com/0x923041-dotcom/Speculae

cd Speculae/desktop

npm install

npm run tauri dev

Architecture

speculae/ ├── src/speculae/ │ ├── cli.py # CLI entry points │ ├── db.py # SQLite + FTS5 │ ├── models.py # Entry, Pattern, Insight │ ├── patterns.py # Pattern detectors │ ├── insights.py # Weekly mirror report │ ├── embeddings.py # Local semantic search │ ├── wellness.py # Breathing & meditation │ ├── config.py # TOML configuration │ ├── image_storage.py # File-based images │ ├── web/server.py # REST API │ └── ui/ # Terminal UI ├── desktop/ # Tauri shell └── pyproject.toml # Package config

Data Model & Storage

  • SQLite database with FTS5 for full-text search
  • Entries store date, agent_id, content, mood (1-5), energy (1-5)
  • Images stored as files with metadata
  • Multi-agent support with agent-scoped patterns
  • Local storage only - no network required

Key Features

  • REST API with 38+ endpoints
  • Statistical pattern detection with t-tests
  • Optional AI-powered insights
  • Command-line interface
  • Tauri desktop application
  • Web server for browser access

Data & Privacy

Your privacy is not a feature we add—it's the foundation everything is built on.

Zero Telemetry

No analytics, no crash reporting, no background pings. Ever.

Zero Network

All pattern detection and search run locally. No external services.

AI Insights Opt-In

When enabled, only statistical summaries are sent. Raw entries never leave your machine.

Your Data, Your Rules

SQLite database is a single file. Copy, backup, or delete anytime.