Local
Run Kowalski without Docker
You may also opt to run Kowalski without Docker on your local machine. This is not recommended for most users, as the setup and maintenance is more difficult.
However, if you want to run Kowalski this way, follow the steps below.
Running Locally
Clone the repo
git clone --recurse-submodules https://github.com/ABOCN/TelegramBotInstall dependencies
bun install # installs deps for bot
cd webui
bun install # installs deps for webuiDeploy necessary components
- Postgres You will need a Postgres server for storing users
- FFmpeg Make sure FFmpeg is installed for video download commands
- Ollama (optional) If you want to use AI features, you will need to install Ollama.
Setup your .env
In order to successfully deploy Kowalski, you will need to have a valid .env. An example is provided in .env.example. You will need to edit both your .env file and enter matching values in webui/.env. Don't worry... it's mostly copy-paste!
You can learn more about the different options in the .env section.
Further setup may be needed for GPUs. See the Ollama documentation for more.
Run the bot and WebUI
chmod +x start-services.sh # makes the script executable
./start-services.sh # starts the bot and webuiIf you want to run the bot and WebUI separately, you can do so with:
# In terminal 1
bun start
# In terminal 2
cd webui
bun devEfficient Local (w/ Docker) Development
If you want to develop a component of Kowalski, without dealing with the headache of several terminals, we suggest you follow these guidelines:
- If you are working on one component, run it with Bun, and Dockerize the other components.
- Minimize the amount of non-Dockerized components to reduce headaches.
- You will have to change your
.enva lot. This is a common source of issues. Make sure the hostname and port are correct.