AI tools, scored for your job
Get paid to train AI
🤝 You're in the Free & Open Source library — community-built tools you can use without paying. A different concept from our scored AI directory.
Home › Free & Open Source › Writing › StoryCraftr
✦ Free & open sourceWriting

StoryCraftr

Command-line tool that helps you outline, worldbuild and draft book chapters with an LLM you choose.

Command-line AI assistant for drafting books

Outline, worldbuild and draft chapters from the terminal with OpenAI, OpenRouter or Ollama.

Free forever · open source · MIT
✓ Light setup✓ Browser-based✓ Real-time collaboration
5.4
ZEKAI
Terminal tool for novelists
Free & open source · Writing
Ease of setup5
Usefulness6
Maintenance5.5
Community5
★ 176
GITHUB
Mar 2026
UPDATED
MIT
LICENSE
🛠 Don't want to self-host? We can set it up →
⚡ Quick answer

StoryCraftr is an open-source command-line assistant for writing books with AI. It suits writers comfortable in a terminal who want outlines, worldbuilding notes and chapters organized as project files.

Runs on
Cross-platform
Hosting
Desktop
Languages
Python
License
MIT

What it is

You start a book project with storycraftr init, set a language, genre, author and model provider, then run commands for outlines, worldbuilding and chapters. A chat mode lets you iterate, for example insert a new chapter mid-book. It runs on LangChain and supports OpenAI, OpenRouter and Ollama.

Who it's for

It suits novelists who like scriptable workflows and project folders with a storycraftr.json config. It does not suit writers who want a point-and-click editor; the only interface besides the terminal is a VS Code extension.

Key features

Book project init

storycraftr init sets title, languages, genre, author and model in a project.

Outline generation

Commands create a general outline, character summaries and chapter synopses.

Worldbuilding commands

Generate geography, history, technology or a magic system for your setting.

Chapter drafting

Write chapters, cover text and epilogues from your synopsis.

Chat with iterate

Interactive chat can insert or rewrite chapters, outlines and worldbuilding.

Multiple model providers

Works with OpenAI, OpenRouter and Ollama via LangChain.

How to start

Up and running in 3 steps

1
Install it with pipx: pipx install git+https://github.com/raestrada/[email protected].
2
Put your provider key in ~/.storycraftr/ (for example openai_api_key.txt) or point it at a local Ollama server.
3
Run storycraftr init with a title, language and genre, then storycraftr chat --book-path to start working.
Real talk

Our honest verdict

What's great

  • Multi-language projects are built in: init takes a primary language and alternate languages.
  • You can pick OpenAI, OpenRouter or a local Ollama model per project in storycraftr.json.
  • Worldbuilding, outline and chapter commands share one project, so context stays together.
  • A VS Code extension lets you start the chat from inside your editor.

Where it falls short

  • It is a command-line tool installed with pipx or uvx from a pinned git tag; there is no standalone installer or graphical editor.
  • You supply your own API key or run a local Ollama model, which means paying per use or having suitable hardware.
  • The latest release is v0.12.0-beta10, so the README itself marks it as beta software.
  • The default embedding model is BAAI/bge-large-en-v1.5; the README suggests a lighter one on constrained hardware.
Cost

Pricing & license

Free under the MIT licence and no paid plan is shown in the README. You pay your model provider, or run Ollama yourself.

Paid work

Open remote AI-training roles

870 open remote AI-training roles, updated November 14, 2026; most pay $20–$170 an hour. Zekai lists them free; the application goes to the employer’s platform.

See all open roles →
Compare

Alternatives

🎁 Free & open-source alternatives

These reviewed AI tools do the same job instantly — from our scored directory.

Get more

Use it, or have us set it up

📄 Free PDF: StoryCraftr for Writing
A plain-language guide to getting your first result. Sent to your inbox.
🔔 64 people want a full video tutorial — add your vote
🛠 Don't want to set it up yourself?
We'll install, host & configure StoryCraftr for you — and train your team.
Get it done for you ↗
Questions

FAQ

Which AI providers does it support?

The README says OpenAI, OpenRouter and Ollama work out of the box, selected with llm_provider in storycraftr.json.

Can I use it without paying for an API?

The README lists Ollama for self-hosted models, which usually needs no key, but you must run Ollama on your own hardware.

Is there a graphical interface?

No. It is a command-line tool, though a VS Code extension can launch the chat for you.

Radar

Latest AI news

✉️ The weekly free toolkit
The best new free & open-source tools for Writing — one short email a week, in your language.
Free · 1 email/week · unsubscribe anytime
Get paid to train AI →

See Zekai first in Google