This bot aims to support various Toki Pona needs on Discord, particularly Sitelen Pona and access to dictionaries such as Linku and Kemeka.

This is a collaborative project brought to you by the Toki Pona community.

Your help is welcome! Feel free to submit pull requests if you find anything that needs improvement.

Want to help but you're new to Github? We can help!

You can also join the Discord and talk to the maintainers!

To run in a Podman environment (default):

• Python 3.8+
• pdm
• Podman
• Podman Compose

To run in Docker environment (see Makefile):

• Python 3.8+
• pdm
• Docker
• Docker Compose

To run locally:

• Python 3.8+
• pdm
• fribidi
• libraqm
• Install your dependencies with pdm: pdm install or make init

You likely already have the last two, but a symptom of not having them is that /sp will emit normal text instead of sitelen pona!

• Create a bot account on the Discord developer portal. Follow official Discord instructions for that.
• Make sure to enable the following in the developer portal:
  • Scopes:
    • bot
    • applications.commands
  • Permissions:
    • Send Messages
    • Send Messages in Threads
    • Embed Links
    • Attach Files
    • Use Slash Commands
• Save your bot token to a .env file as DISCORD_TOKEN=longstringofcharactersyougotfromtheportal.
• Run the bot: make build up or make local, if you want the containerized or local bot respectively.

ilo Linku is licensed under GPL-3.0.