Windows
Quick install instructions
- Download and install Python 3.10 - 3.13 from the official Python website.
- Click here for direct link to python 3.11.9 download
- June 2025: people have reported issues with python 3.13 still, due to some dependencies not being available yet, if you run into issues during installation try downgrading.
- Download and install Node.js from the official Node.js website. This will also install npm.
- Download the Talemate project to your local machine. Download from the Releases page.
- Unpack the download and run
install.bat
by double clicking it. This will set up the project on your local machine. - Optional: If you are using an nvidia graphics card with CUDA support you may want to also run
install-cuda.bat
afterwards, to install the cuda enabled version of torch - although this is only needed if you want to run some bigger embedding models where CUDA can be helpful. - Once the installation is complete, you can start the backend and frontend servers by running
start.bat
. - Once the talemate logo shows up, navigate your browser to http://localhost:8080
First start up may take a while
We have seen cases where the first start of talemate will sit at a black screen for a minute or two. Just wait it out, eventually the Talemate logo should show up.
If everything went well, you can proceed to connect a client.
Additional Information
How to Install Python
Supported Versions
As of Talemate 0.30
the following python versions are supported: 3.10
, 3.11
, 3.12
or 3.13
- Visit the official Python website's download page for Windows at https://www.python.org/downloads/windows/.
- Find the latest updated of Python 3.13 and click on one of the download links. (You will likely want the Windows installer (64-bit))
- Run the installer file and follow the setup instructions. Make sure to check the box that says Add Python 3.13 to PATH before you click Install Now.
How to Install npm
- Download Node.js from the official site https://nodejs.org/en/download/prebuilt-installer.
- Run the installer (the .msi installer is recommended).
- Follow the prompts in the installer (Accept the license agreement, click the NEXT button a bunch of times and accept the default installation settings).
Usage of the Supplied bat Files
install.bat
This batch file is used to set up the project on your local machine. It creates a virtual environment, activates it, installs poetry, and uses poetry to install dependencies. It then navigates to the frontend directory and installs the necessary npm packages.
To run this file, simply double click on it or open a command prompt in the same directory and type install.bat
.
update.bat
If you are inside a git checkout of talemate you can use this to pull and reinstall talemate if there have been updates.
CUDA needs to be reinstalled manually
Running update.bat
will downgrade your torch install to the non-CUDA version, so if you want CUDA support you will need to run the install-cuda.bat
script after the update is finished.
start.bat
This batch file is used to start the backend and frontend servers. It opens two command prompts, one for the frontend and one for the backend.
To run this file, simply double click on it or open a command prompt in the same directory and type start.bat
.