An AI-powered multiplayer interactive fiction platform. Create any world you want — the AI generates prose, images, and game mechanics. Play alone or with friends.
- Node.js (v18 or higher)
- npm (v8 or higher)
- OpenAI API key
- Clone the repository and install dependencies
git clone https://github.com/OdinMB/chosenpath.git
npm run install:all- Create environment files
Create .env based on .env.sample in the server directory.
Create .env based on .env.sample in the client directory.
- Start the development servers
npm run devThis will start:
- Client at http://localhost:5173
- Server at http://localhost:3000
Chosen Path is built on a narrative simulation engine that handles AI-powered story generation, branching mechanics, stat systems, outcome resolution, and multiplayer coordination.
We plan to extract this engine into a standalone package (chosenpath-engine) so that other projects — education platforms, coaching tools, training simulations, research applications — can integrate interactive narrative capabilities without forking the full application.
If you're interested in using the engine in your own project, open an issue or get in touch. Your use case will help shape the extraction priorities.
Contributions are welcome! Please read CONTRIBUTING.md before submitting a pull request.
Chosen Path is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later).
If you deploy a modified version of this software as a network service, you must make your modified source code available under the same license. See the LICENSE file for full terms.
For alternative licensing arrangements (e.g., commercial use under different terms), see the Stewardship page.
