Installation¶
Add hikari-risa to your bot's project. It runs on Python 3.12 to 3.15, and you import it as risa.
Install¶
uv add hikari-risa
pip install hikari-risa
This also installs what risa depends on: hikari, linkd and msgspec. uv add needs a project to add to, so run
uv init first if you have no pyproject.toml yet.
Run hikari-risa to check that it worked. It prints the version of risa, where it is installed and the versions of
Python and of what risa installs; paste that into a bug report.
uv run hikari-risa
hikari-risa
python -m risa does the same, and hikari-risa --version prints only the version.
Extras¶
A view keeps its state in its message by default, and that needs nothing extra. Three extras add more:
| Extra | Installs | You want it when |
|---|---|---|
redis |
redis |
Your views keep their state in Redis, with RedisStore. |
postgres |
asyncpg |
Your views keep their state in PostgreSQL, with PostgresStore. |
radixly |
radixly |
A view runs out of room in its message. The codecs BASE32768 and URO14 fit more than twice as much. |
Name one when you install:
uv add "hikari-risa[redis]"
pip install "hikari-risa[redis]"
Packages your bot may need¶
Two more packages depend on how your bot runs, and hikari-risa installs neither:
- A bot with slash commands through lightbulb needs
hikari-lightbulb. - A REST bot needs
hikari[server], because hikari's interaction server checks Discord's signatures with it.
Your first view is the next step.