vrr/talemate
2
0
Fork 0
mirror of https://github.com/vegu-ai/talemate.git synced 2026-07-24 15:24:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
talemate/docs/getting-started/installation/linux.md
veguAI c12a82930e
Some checks failed
ci / container-build (push) Has been cancelled
Details
ci / deploy-docs (push) Has been cancelled
Details
Python Tests / test (3.11) (push) Has been cancelled
Details
0.38.0 (#272) 
- **Per-Scene Agent Overrides** — Override agent configuration for a single scene without touching your global config.
- **Message Revision History** — Browse and continue from previous regenerations / revisions.
- **Scene Perspective Overrides** — Set distinct narrative perspectives for the player, NPCs, and narrator.
- **Durable World State Snapshot** — The world state snapshot now persists and updates entities across refreshes.
- **World State Highlights** — Characters, objects and places marked by the current world state snapshot are now clickable in the recent message(s) for additional detail.

Plus 30 improvements and 17 bug fixes
2026-07-02 09:28:45 +03:00

1.8 KiB
Raw Permalink Blame History

Quick install instructions

Dependencies

--8<-- "docs/snippets/common.md:python-versions"

  1. python - see instructions here
  2. uv - see instructions here

install.sh downloads a portable Node.js 22 runtime automatically (used to build the frontend), so you do not need to install Node.js yourself.

Installation

  1. git clone https://github.com/vegu-ai/talemate.git
  2. cd talemate
  3. source install.sh
    • When asked if you want to install pytorch with CUDA support choose y if you have a CUDA compatible Nvidia GPU and have installed the necessary drivers.
  4. source start.sh

If everything went well, you can proceed to connect a client.

Additional Information

Setting Up a Virtual Environment

  1. Open a terminal.
  2. Navigate to the project directory.
  3. uv will automatically create a virtual environment when you run uv venv.

Installing Dependencies

  1. Use uv to install dependencies by running uv pip install -e ".[dev]".

Running the Backend

  1. You can start the backend server using uv run src/talemate/server/run.py runserver --host 0.0.0.0 --port 5050.

Running the Frontend

Unlike the quick install above, this manual path does not provision Node.js for you — install Node.js 22+ yourself (see here). Corepack ships with it and provides pnpm.

  1. Navigate to the talemate_frontend directory.
  2. If you haven't already, install frontend dependencies by running corepack pnpm install.
  3. Start the server with corepack pnpm run serve.

Please note that you may need to set environment variables or modify the host and port as per your setup. You can refer to the various start scripts for more details.