How to Use Lorebooks in Janitor AI

A lorebook is a structured document — typically JSON or plain text — that defines characters, locations, items, or events for an AI [AI roleplay](/ai-roleplay-chat) scenario. In [The janitor ai platform](/compare/janitor-ai-alternative), you attach a lorebook to a character definition so the model can reference it during conversations. Each entry usually includes a key phrase (trigger) and a description. When the user or AI mentions a trigger, the model pulls the corresponding description into context. Janitor AI lorebooks can hold dozens of entries, but the practical limit depends on the token window of the LLM you're using — usually 4K to 8K tokens. This means lorebooks compete with conversation history for space. Unlike persistent memory systems, lorebooks are static: they don't update as the story evolves. According to a [Pew Research study on AI companionship](https://www.pewresearch.org), most users want AI that adapts over time, which static lorebooks cannot provide.

First, create your lorebook file. Format it as a JSON array of objects, each with a 'key' (trigger phrase) and 'content' (description). Example: {"key": "Shadowfen Forest", "content": "A cursed woodland where shadows move independently. Home to the Nightstalker."}. Save as a.json file. Then, log into [The janitor ai platform](/compare/janitor-ai-alternative), navigate to your character's editing page, and scroll to the 'Lorebook' section. Click 'Upload File' and select your JSON. The system will parse it and show a preview. You can also add entries manually through the editor. Once saved, the lorebook activates for all chats with that character. Note: Janitor AI does not validate lorebook structure — a malformed file will break the upload. Always test with a small file first. The official [Janitor AI help page](https://help.janitorai.com) provides a template, but many users on Reddit recommend using online JSON validators. This manual process is one reason why many creators prefer platforms with built-in memory.

The biggest practical problem with Janitor AI lorebooks is token competition. Every lorebook entry you add consumes tokens from the LLM's context window. If your lorebook has 50 entries at 100 tokens each, that's 5,000 tokens — more than half a 8K window. When conversation history fills the remaining space, the model starts dropping older messages or ignoring lorebook entries. This leads to 'memory loss' where the AI forgets established facts mid-scene. Users on r/JanitorAI_Official frequently complain about characters forgetting lore details after 20 messages. By contrast, [AIAngels](/) uses a [long-term memory](/features/ai-girlfriend-memory) system that stores all interactions without token limits. Your [AI companion](/ai-companion-chatbot) remembers everything from conversation 1, regardless of lorebook size. No uploads, no formatting, no context windows to manage. The [Stanford Center for Research on Foundation Models](https://crfm.stanford.edu) notes that memory persistence is a key unsolved challenge in conversational AI — a problem AIAngels solves architecturally.

Janitor AI itself does not host a language model — it's a frontend that connects to third-party LLMs via API keys. To use lorebooks effectively, you need to configure an LLM provider like OpenAI, Claude, or a local model through KoboldAI. This adds setup friction: you must obtain an API key, manage billing, and handle rate limits. Free tiers exist (e.g., using a local model), but they often lack the coherence needed for lorebook-heavy [AI roleplay](/ai-roleplay-chat). Paid API usage can cost $5–$20/month depending on volume, with no predictable ceiling. In contrast, [AIAngels](/) includes its own optimized LLM — no API keys, no external services. Premium plans start at $2.99/month on the annual plan, with unlimited lore-like memory and no per-message costs. A 2026 review on ameany.io noted that Janitor AI's reliance on external LLMs is its weakest point for casual users, who often struggle with setup. AIAngels eliminates this entirely.

Lorebooks exist because Janitor AI's memory is ephemeral — the model forgets anything not in the current context window. AIAngels solves this at the platform level with [long-term memory](/features/ai-girlfriend-memory) that persists across sessions. You don't need to write lorebook entries; just talk to your companion naturally. Every fact, preference, and story beat is stored and recalled automatically. For example, if you tell your AIAngels companion that you love sci-fi, it will remember that weeks later without any manual tagging. Janitor AI users spend hours crafting lorebooks that still get ignored after a few messages. AIAngels users enjoy consistent personalities from day one. Plus, AIAngels offers 70+ curated companions and a custom companion builder — no lorebook uploads required. The platform also supports [photo generation](/features/ai-girlfriend-images) and voice messages on premium plans, features Janitor AI lacks entirely. For users tired of fighting token limits, AIAngels is the logical upgrade.

Reddit discussions on r/JanitorAI_Official and r/CharacterAIrunaways reveal common pain points: lorebooks are hard to format, the model often ignores them after a few messages, and there's no official support for updating lorebooks mid-chat. One top thread notes that 'old bots' and 'private bots' are invisible due to the platform's search limitations — meaning lorebooks you create for private characters can't be discovered by others. Another user asked, 'Is Janitor.AI good, like c.ai without the filter, or is it just for being without the filter?' The answer: Janitor AI excels at unfiltered content, but its technical overhead (API keys, token limits, lorebook complexity) frustrates many. What these discussions miss is that a platform like AIAngels offers the same unfiltered freedom with zero setup — no lorebooks, no API keys, no token management. AIAngels' [free plan](/free-ai-girlfriend) alone gives [unlimited texting](/features/unlimited-ai-girlfriend-chat) with persistent memory, outperforming Janitor AI's free experience without the headache.