THOTH → dwtj → Djehuty ( pronounced Jeh - hoo - tee )

Write like
yourself.
At scale.

Thoth learns your voice, your knowledge, your publishing patterns; then helps you write original technical content that sounds like you, not an LLM.

$ npm install -g @serticode/thoth

Free forever with local Ollama; no API key required.   Your data never leaves your machine.

thoth zsh

Three profiles.
One voice.

Thoth builds a model of you in three dimensions.
- What you know
- How you communicate
- What you've published.
Then uses that model to generate content that is unmistakably you.

01
🧠

Knowledge Profile

What you know.
- Extracted from your repos, architecture docs, and technical notes.
- Powers factual accuracy and real examples.

Architecture notes Repository docs Technical journals
02
🎙️

Voice Profile

How you communicate.
- Tone, pacing, vocabulary, storytelling rhythm; all extracted from essays, journals, and reflections.

Personal essays Journals & reflections Blog drafts
03
📄

Publication Profile

What you've built publicly.
- Tracks article relationships, series continuity, and your publishing evolution over time.

Medium articles Published series Article history
01

Initialize

Creates a local SQLite database at ~/.thoth/. No cloud. No account.

$ thoth init
02

Import your sources

Point Thoth at your notes, repos, or articles. It chunks, embeds, and stores locally.

$ thoth import_voice ./journals
03

Generate your profiles

Thoth analyses your imports and builds the three identity profiles. Runs once, updates on demand.

$ thoth generate_profile
04

Research a topic

Search your knowledge sources with semantic retrieval. Thoth returns a structured research note with cited sources.

$ thoth research "Offline First"
05

Draft your article

Give Thoth a topic or research ID. It generates an article in your authentic voice, combining profiles with optional research context.

$ thoth generate_article --topic "Offline First" --research rn_abc123
thoth demo
init
import
profile
research
draft
$thoth init
✦ Thoth v1.0.0
Creating database at ~/.thoth/thoth.db
Running migrations...
✓ Database ready
✓ Vector store initialized
 
No AI keys detected.
Falling back to Ollama (local).
✓ Ollama connected llama3.2
 
Run: thoth import_voice <path>
$thoth import_voice ./essays
Scanning ./essays...
Found 14 markdown files
 
Chunking content (512 tokens, 50 overlap)
✓ 127 chunks created
Generating embeddings via Ollama...
✓ 127 embeddings stored
 
$thoth import_knowledge ./architecture
Found 8 files
✓ 73 chunks embedded
$thoth generate_profile
Analysing voice sources (127 chunks)...
✓ Voice profile generated
 
  Tone cinematic, second person
  Pacing deliberate, story first
  Vocabulary technical with metaphor
 
Analysing knowledge sources (73 chunks)...
✓ Knowledge profile generated
✓ Publication profile generated
 
Identity engine ready.
$thoth research "Offline First Mobile Apps"
Researching: "Offline First Mobile Apps"
 
Distributed offline-first systems face three primary
challenges: conflict resolution, sync strategy, and
local-first data architecture...
 
Sources cited: 5
Research ID: rn_abc123
$thoth generate_article --research rn_abc123
Generating article...
Applying voice profile...
Applying knowledge profile...
Generating outline → draft...
✓ Article generated (1,640 words, ~9 min read)
 
ID: art_abc123

Your data.
Your machine.

Thoth is a CLI tool.
Everything your profiles, embeddings, drafts; lives in a SQLite database on your own filesystem.

🔒

Local by default

All data is stored at ~/.thoth/thoth.db. Nothing is sent to Thoth servers; there are none.

🤖

Ollama is the local fallback

No API key needed — Thoth uses Ollama when no cloud keys are detected. OpenAI, Groq, Gemini, and Anthropic are opt-in for higher quality.

🔑

You control which provider sees your data

If you opt into a cloud provider, source content is sent for profile generation and embedding. Use --local to keep everything on your machine.

📦

Open source

The full source is on GitHub. Audit what runs. Fork it. Own it entirely.

Ollama free
Install 01
# Node 22+ required
npm install -g @serticode/thoth
Local setup (no API key) 02
# Pull required Ollama models
ollama pull llama3.2
ollama pull nomic-embed-text

thoth init
Import & profile 03
thoth import_voice ./notes
thoth import_knowledge ./docs
thoth import_publications ./articles
thoth generate_profile
Write your first article 04
thoth generate_article --topic "BLoC vs Riverpod"

# Optional: upgrade provider or set default in thoth.json
export GEMINI_API_KEY=AIza...
thoth generate_article --topic "BLoC vs Riverpod"