Getting started

Create a project

Choose a folder for the project. 1667 stores the story and its settings in that folder.

On macOS or Linux:

mkdir my-story
cd my-story
1667 init
1667

On Windows PowerShell:

mkdir my-story
cd my-story
1667.exe init
1667.exe

1667 init creates a .1667 directory. Run 1667 from the project folder or one of its subfolders.

Use the starter stories

A new project contains two starter stories. Open Start Here first.

The story explains the main keys. It also shows parts, takes, the map, Facts, and Settings. Delete the starter stories when you no longer need them.

Press o to open the Library and change stories. Press ? to open the full key reference.

Connect a model

The starter tour uses a dry-run provider. It does not contact an external service.

Press , to open Settings. Open Connection, then choose a provider. Enter the model and connection details that the provider requires. Save Settings.

You can write and edit takes without a provider. A provider is required only for model requests.

See Write with a local model for Ollama, LM Studio, llama.cpp, and KoboldCpp.