Skip to content

Commit db354d4

Browse files
committed
docs(seo): make the repo discoverable for what it actually is
Repo had 13 topics (limit 20) and a description that omitted the terms people search for. GitHub indexes the description, topics, and README hero; none were carrying their weight. Repo metadata (applied via gh, not in-tree): - description now names the mechanisms and every supported provider, which is what search matches on - +7 topics -> 20/20: mcp, model-context-protocol, ai-roleplay, long-term-memory, ai-companion, sillytavern, chatbot README hero: - H1 carries the product category ("self-hosted AI roleplay client with long-term memory") rather than just the project name — the H1 is what Google renders as the title - explicit "alternative to SillyTavern / RisuAI / Faraday" line, since "sillytavern alternative" is how people actually search this category - badges (docker, license, tests) - a differentiators line and an intent-matching line covering the long-tail phrasings DELIBERATELY NOT CLAIMED: model-independent character continuity, or any number from the retracted benchmark. That claim was withdrawn earlier today (e27b74d) and must not re-enter through marketing copy. The SEO sells the memory substrate, the privacy ACL, and MCP support — all of which are shipped and demonstrable. Still worth doing later: a social preview image (og:image), which GitHub uses for link unfurls on X/Reddit/HN and which no amount of text can substitute for.
1 parent d657873 commit db354d4

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,18 @@
1-
# Chronicler
1+
# Chronicler — self-hosted AI roleplay client with long-term memory
22

3-
**Local-first roleplay client with a memory that actually works.**
3+
**A local-first alternative to SillyTavern, RisuAI, and Faraday, built around memory that survives long campaigns.**
44

5-
Chronicler is an open-source, self-hosted roleplay/character-chat app. You run it on your own machine via `docker compose up`. It imports the community v2/v3 character-card format (chub.ai-compatible), talks to any OpenAI-compatible LLM endpoint (OpenAI, Anthropic, Ollama, OpenRouter, llama.cpp, vLLM, nano-gpt, …), and remembers the things that matter about every character across every session — automatically, locally, without sending anything to a cloud.
5+
[![Docker images](https://img.shields.io/badge/docker-ghcr.io-blue?logo=docker)](https://github.com/orgs/yantrikos/packages)
6+
[![License](https://img.shields.io/badge/license-see%20LICENSE-lightgrey)](LICENSE)
7+
[![Tests](https://img.shields.io/badge/tests-27%2F27%20green-brightgreen)](#develop)
68

7-
> The problem with existing RP clients isn't the UI — it's that memory falls apart after a few sessions. Chronicler is built around a persistent cognitive memory engine (YantrikDB) and a strict three-tier write contract that keeps canon clean and accumulates real continuity over hundreds of hours.
9+
Chronicler is an open-source, self-hosted **AI roleplay and character-chat app** you run on your own machine with `docker compose up`. It imports the community **v2/v3 character card** format (chub.ai-compatible), talks to **any OpenAI-compatible LLM** — Ollama, OpenAI, Anthropic, OpenRouter, llama.cpp, vLLM, nano-gpt — and remembers what matters about every character across every session, automatically and locally, without sending anything to a cloud.
10+
11+
> The problem with existing RP clients isn't the UI — it's that **memory falls apart after a few sessions**. Chronicler is built on a persistent cognitive memory engine ([YantrikDB](https://github.com/yantrikos/yantrikdb)) with a strict three-tier write contract that keeps canon clean and accumulates real continuity over hundreds of hours.
12+
13+
**What you get that other clients don't:** verified long-term memory instead of a rolling summary · per-memory `visible_to` ACL so characters can't recall secrets they were never told · a prompt inspector showing exactly what was sent and why · **native MCP support** (tools, resources, prompts) · an extension SDK on npm.
14+
15+
**Looking for** a SillyTavern alternative with real memory · an AI companion that remembers across sessions · a local/offline character chat app · long-term memory for LLM roleplay · an MCP-native chat client? That's what this is.
816

917
---
1018

0 commit comments

Comments
 (0)