Documentation
What is Entangled Text?
Use this page as the canonical product reference. For a machine-readable summary, see llms.txt.
Everything you need to know about writing books with Entangled Text.
Getting Started
- Create a free account. No credit card or subscription required. Just a username, email, and password.
- Complete onboarding. Set your display name (pen name), add your first API key, and optionally create your first book.
- Add an API key. Go to Dashboard → API Keys and paste a key from any supported AI provider. Keys are encrypted with AES-256-GCM before storage.
- Create a book. Click New Book, pick a genre preset, set your target word count and chapter count, then describe your story.
- Generate content. Use the outline tool to plan your story, then generate chapters one at a time or all at once.
- Edit and refine. Every chapter is fully editable. Revise AI output to match your voice.
- Export or publish. Download your book as TXT, Markdown, DOCX, EPUB, or PDF — or publish it directly to the platform for others to read.
API Keys
Entangled Text uses your own AI provider API keys (BYOK — Bring Your Own Key). This means you pay the AI provider directly based on your usage, and we never see your API bills. The platform itself is free.
Supported providers:
GPT-4o, GPT-4.1, o3, o4-mini & more
Claude Opus, Sonnet & more
Gemini 2.5 Pro, Flash & more
Large, Medium & more
Chat, Reasoner
Grok models
You can add keys for multiple providers and switch between them per project. Set a default provider to use it automatically for new projects.
Creating a Book
Creation Modes
When starting a new book, you choose one of three modes:
- Quick Start — Pick a genre, write a short prompt describing your story, and go. The AI fills in sensible defaults for tone, pacing, perspective, and structure based on your genre. Best for getting started fast.
- Customized — Full control over every aspect of your book: perspective (first/third person), tense, tone, pacing, dialogue density, violence/romance/humor levels, world-building depth, magic systems, target audience, and much more. Best for experienced authors who want precise control.
- Existing Book — Paste your existing chapters and the AI analyzes your writing style, characters, and voice to continue the story consistently. It extracts a "voice fingerprint" and character roster to maintain consistency. Best for authors with a work-in-progress.
Genre Presets
Genre presets configure the AI's writing style, tone, pacing, and structure to match genre conventions. Each preset includes a curated writing guide that helps the AI produce genre-appropriate prose.
Available genres include:
- Fantasy — Epic, Dark, Urban, Progression, LitRPG, Cultivation, Sword & Sorcery, Romantic, Paranormal, High Fantasy
- Sci-fi — Space Opera, Hard Sci-fi, Cyberpunk, Military Sci-fi, Time Travel, Post-Apocalyptic Sci-fi, Dystopian Sci-fi
- Romance — Contemporary, Historical, Paranormal, Romantic Suspense, and more
- Mystery & Thriller — Cozy Mystery, Police Procedural, Psychological Thriller, Legal Thriller, Espionage
- Horror — Gothic, Cosmic, Slasher, Psychological Horror
- Literary Fiction, Historical Fiction, Young Adult, Adventure & Action, Western, Humor & Comedy, Dystopian, Women's Fiction, LGBTQ+ Fiction, Crime, Military & War, Superhero, and more
Each genre has sub-genres with their own tuned settings. You can further customize any preset's settings after selecting it.
Story Settings
In Customized mode (and as overrides in Quick Start), you can configure:
- Title & description — Your book's title and a short synopsis
- Story prompt — A detailed description of your plot, characters, and world
- Target word count — 1,000 to 500,000 words
- Target chapters — 1 to 100 chapters
- Words per chapter — Min and max word count per chapter
- AI provider & model — Which AI to use for this project
- Perspective — First person, third person limited, third person omniscient
- Tense — Past or present tense
- Tone & pacing — From lighthearted to dark, slow-burn to fast-paced
- Content levels — Dialogue density, description density, action, violence, romance, humor, darkness (each on a scale)
- World building — Depth of world-building, magic system details, technology level
- Character bible — Detailed character descriptions the AI references for consistency
- Plot beats — Key story events the AI should hit
- Themes — Thematic elements to weave throughout
- Negative prompts — Things to explicitly avoid
- Name blacklist — Character names the AI should never introduce
- Progression/LitRPG options — Stats, levels, skill systems for genre-specific books
AI Generation
Outline Generation
Before generating chapters, you create an outline that maps out your entire book. The AI uses your story prompt, genre settings, and all configured options to produce a structured chapter-by-chapter plan.
For Existing Book mode, the outline is generated from your manuscript — analyzing what you've already written and planning where the story should go next.
You can edit the outline before proceeding. The outline serves as the roadmap for all subsequent chapter generation.
Chapter Generation
Once your outline is ready, you can generate chapters in several ways:
- Sample chapter — Generate just the first chapter to preview the AI's style before committing to the full book.
- One at a time — Generate the next chapter, review it, edit if needed, then continue.
- Full book — Generate all remaining chapters sequentially. The AI writes each chapter in order, using previous chapters as context for consistency.
The AI builds rich context for each chapter including: the system prompt with all your settings, the outline, a summary of previous chapters, and the most recent chapter content. This ensures characters stay consistent, plot threads are maintained, and the writing style remains uniform.
Chapter Management
Every generated chapter is fully editable. From the Chapters tab in the book editor, you can:
- Edit content — Full text editor for every chapter. Change anything the AI wrote.
- Edit titles — Rename chapters to your liking.
- Delete chapters — Remove chapters you don't want.
- Finalize chapters — Mark a chapter as finalized when you're happy with it.
- Publish individually — Publish specific chapters to make them publicly readable while keeping others as drafts.
The Chapters dashboard page gives you a bird's-eye view of all chapters across all your projects, grouped by book with word counts, reading times, and publish status.
Exporting
Export your finished book in any of five formats from the Export tab:
- TXT — Plain text. Universal compatibility.
- Markdown — Formatted text with headings and structure. Great for further editing in tools like Obsidian or Notion.
- DOCX — Microsoft Word format. Ready for traditional publishing workflows or further formatting.
- EPUB — Industry-standard ebook format. Ready for Kindle (via KDP), Apple Books, Kobo, and all major ebook platforms.
- PDF — Formatted document. Good for print-on-demand or sharing.
EPUB and DOCX exports can include metadata you configure in Book Details: author name, copyright, publisher, dedication, and "about the author" blurb. You can set defaults for these fields in your account settings.
Publishing
You can publish your stories directly on Entangled Text for anyone to read — think of it as a built-in reading platform like Royal Road or Wattpad.
- Publish the full story — Makes your book visible on the Books page with its own public story page.
- Publish individual chapters — Release chapters one at a time. Followers get email notifications for each new chapter.
- Unpublish — Take your story or individual chapters offline at any time.
Published stories get a permanent URL you can share anywhere. Each story page shows your cover image, description, chapter list, word count, and a comment section.
Discovery & Reading
The Books page is the public catalog of all published stories and chapters. Readers can:
- Browse by Books or Latest Chapters — Two views: a grid of book covers, or a chronological feed of recently published chapters.
- Filter by genre — Click genre chips to narrow results.
- Search — Find stories by title or keyword.
- Filter by time period — Last 24 hours, 7 days, 30 days, or all time.
- Sort — By newest, oldest, word count, or title.
The reading experience includes chapter navigation (previous/next buttons, chapter dropdown), a sidebar with book metadata, and both chapter-level and story-level comment threads.
Community Features
Comments
Logged-in users can comment on published stories and individual chapters. Comments support:
- Threaded replies — Reply to any comment to start a conversation thread.
- Edit & delete — You can edit or delete your own comments at any time.
- 5,000 character limit per comment.
Manage all your comments from the My Comments page in your dashboard.
Favorites & Following
- Favorites — Save stories to your favorites list. They appear on your dashboard with badges when new chapters are available.
- Follow — Follow a story to receive email notifications when new chapters are published. The follow button (bell icon) is on every story page.
Author Profiles
Every author who publishes a story gets a public profile page showing their avatar, bio, social links, and all their published stories. Author names on story and chapter pages link directly to their profile.
Configure your profile from Dashboard → Account: set a display name, upload an avatar, and add social media links (Twitter/X, Bluesky, Instagram, YouTube, Patreon, and more).
Account & Settings
From Dashboard → Account, you can manage:
- Profile — Display name and avatar (JPEG, PNG, GIF, or WebP, up to 20 MB with cropping).
- Email — Change your email address (requires current password).
- Password — Change your password (min 10 characters, must include upper, lower, number, and special character).
- Social links — Add links to your social media profiles. These appear on your public author page and on your published stories.
- Daily word goal — Set a target and track your streak on the dashboard.
- Export presets — Save preferred export format combinations.
- Kindle/KDP defaults — Pre-fill author name, copyright, publisher, dedication, and "about the author" for exports.
- Referral link — Share your unique link to invite other authors.
- Delete account — Permanently remove your account and all data (requires password confirmation).
Your dashboard also tracks milestones like your first book, reaching 10,000 and 50,000 words, and your first export.
Security
Your data and API keys are protected by multiple layers of security:
- AES-256-GCM encryption — API keys are encrypted at rest with AES-256-GCM using unique initialization vectors (IVs) and authentication tags. Keys are never stored in plaintext.
- Password hashing — Passwords are hashed with bcrypt (cost factor 12). We never store or see your actual password.
- CSRF protection — All forms and API calls include cross-site request forgery tokens.
- Rate limiting — Login attempts, password resets, registration, content generation, and exports are all rate-limited to prevent abuse.
- Brute-force detection — Repeated failed login attempts trigger account lockouts.
- BYOK model — Your API keys are used directly with AI providers. We never proxy, log, or inspect your AI API calls beyond what's needed to generate your content.
For full details, see the Security & Encryption page.
Feedback & Support
- Feedback — Submit bug reports or feature suggestions from your dashboard. The team is notified immediately.
- Contact — General questions and support inquiries.
- API Guide — Details on how AI provider APIs are integrated.
- Writing Tips — Practical advice for getting the best results from AI-assisted writing.
- AI Editing Guide — Step-by-step guide to editing your manuscript with AI.
- AI Model Comparison — Compare AI models for fiction writing.
- What's New — Latest updates and improvements.
- RSS Feed — Subscribe to new chapter releases in your favorite RSS reader.
Ready to start writing?
Create your free account and write your first book with AI today.
Get Started Free