Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Icon Chaskis

A generic framework written in C# for making IRC Bots.

Build Status

Build status Codacy Badge


NuGet Chocolatey AUR

Docker Images

Windows Ubuntu Raspbian


Chaskis is a framework for creating IRC Bots in an easy way. It is a plugin-based architecture written in C# that can be run on Windows or Linux. Users of the bot can add or remove plugins to run, or even write their own.

Chaskis is named after the Chasqui, messengers who ran trails in the Inca Empire to deliver messages.

Live Demo

You can talk to chaskisbot in our IRC channel on (#chaskis @ Also, feel free to ask any questions there, someone will answer your questions as soon as possible.

You can also join our Telegram Group. This is bridged with the same IRC channel that has chaskisbot in it, so you'll be able to talk with anyone in the IRC channel as well.

Install Instructions


Run the Windows installer. This will install Chaskis to C:\Program Files\Chaskis. The service will also be installed but NOT enabled.

You can also install via chocolatey by running choco install chaskis.


  • Arch - Install with the AUR: yaourt -S chaskis. There is a dependency of the dotnet runtime
  • Debian - Install an up-to-date version of the dotnet core runtime, and install the .deb file.


Once Chaskis is installed, run Chaskis.exe --bootstrap to create an empty configuration in side of your Application Data folder. On Windows, this is C:\Users\you\AppData\Roaming\Chaskis. On Linux, this is /home/you/.config/Chaskis. If you wish to install a default config else where, specify that in the --chaskisroot argument (e.g. Chaskis.exe --bootstrap --chaskisroot=/home/you/chakisconfig).

Note, if running Chaskis as a Service, you MUST store your user's configuration in the Application Data folder.

After running Chaskis.exe with the bootstrap argument, default configurations will appear in the folder. They are XML Files, and their instructions live as comments in those files. Plugin configuration lives in the Plugins folder.



There are two ways to run Chaskis. The first is with Chaskis.exe. By default, this will look for configuration in your Application Data folder, but you can override this by passing in the --chaskisroot argument (e.g. Chaskis.exe --chaskisroot=/home/you/chakisconfig). You can run multiple instances of Chaskis.exe per user this way. Running Chaskis in a tool such as tmux or screen an keep it running in the background.


The other way to run Chaskis is by the service. The advantage of a service is you can tell Chaskis to run when your system starts up. The disadvantage is you can only have on configuration per user, which lives in the user's Application Data folder.

Writing Plugins

Visit our Wiki page here.