Use Scribe with a local llama.cpp, Ollama, or LM Studio server, or point it at a cloud API on weaker hardware. It keeps sessions, files, RAG, and memory in plain local folders.
$ git clone https://github.com/pedjaurosevic/scribe-llm.git
$ cd scribe-llm && ./scripts/install.sh
$ scribe-llm config show
base_url: http://127.0.0.1:18083/v1
workspace: ~/scribe-workspace
$ scribe-llm chat
# Work with files, sessions, RAG, and tools
# inside your local Scribe workspace.
The GitHub install is editable, so a later git pull updates the same checkout. The install script also creates ~/.config/scribe/config.toml and ~/scribe-workspace.
git clone https://github.com/pedjaurosevic/scribe-llm.git
cd scribe-llm
./scripts/install.sh
scribe-llm --version
python3 -m pip install scribe-llm
scribe-llm --help
scribe-llm chat
Scribe talks to OpenAI-compatible APIs. On llama.cpp it can use grammar-constrained tool calls; on cloud providers it falls back to regular tool-call/text parsing.
Good for private work, local files, and long-context setups. Default endpoint is http://127.0.0.1:18083/v1.
Use a smaller model locally, or test Scribe without running a custom server. Set base_url and model.
Useful on weaker machines. Keep the API key in SCRIBE_API_KEY, not in a committed config file.
[scribe]
base_url = "https://api.deepseek.com"
model = "your-deepseek-model"
api_key = "use-env-instead"
reasoning = false
tool_grammar = "off"
export SCRIBE_BASE_URL="https://api.deepseek.com"
export SCRIBE_MODEL="your-deepseek-model"
export SCRIBE_API_KEY="..."
scribe-llm chat
The project is a practical agent stack: model adapter, session manager, local tools, RAG, semantic memory, and a web writing studio.
The agent reads and writes inside a configured workspace directory, with scoped file operations.
Web search, web fetch, source-grounded answers, contradiction tags, and citation-oriented prompts.
SQLite FTS5 plus vector search with multilingual embeddings, combined with reciprocal rank fusion.
Cross-session recall through SME and a durable WorldModel for persistent context.
Command gates, Python AST checks, sandbox support, and git checkpoints for safer local changes.
A localhost web editor for chapters, outlines, terminal work, and Markdown/PDF/EPUB export.
Scribe is usable, but it is still an alpha project. The site should make the boundaries clear instead of overselling them.
base_url, model, and api_key.scribe-llm chatinteractive terminal chatscribe-llm weblocalhost Book Studioscribe-llm discoverfind local model serversscribe-llm status --jsonmachine-readable statusscribe-llm rag searchsearch indexed documentsscribe-llm initcreate a project vaultscribe-llm compareblind A/B model testscribe-llm benchquality and grounding checks