Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.


Odysseia - Discord Bot
Odysseia Discord Bot

Music, Moderation, Trivia, Stream Alerts and Fully Modular.

Discord Server PyPI PyPI - Python Version discord.py Support Odysseia on Patreon!

GitHub Actions Odysseia on readthedocs.org Code Style: Black Localized with Crowdin

Overview • Installation • Documentation • Plugins • Community • License

Overview

Odysseia is a fully modular bot – meaning all features and commands can be enabled/disabled to your liking, making it completely customizable. This is a self-hosted bot – meaning you will need to host and maintain your own instance. You can turn Odysseia into an admin bot, music bot, trivia bot, new best friend or all of these together!

Odysseia is built for Discord, a popular VOIP and instant messaging platform. It's best suited for use in guilds (also known as servers), where it utilizes Discord's well-documented API to communicate and deliver its many features. Discord offers its API to encourage developers to explore their creativity by building programs, tools, and services that enhance the Discord experience.

Installation is easy, and you do NOT need to know anything about coding! Aside from installing and updating, every part of the bot can be controlled from within Discord.

The default set of modules includes and is not limited to:

  • Moderation features (kick/ban/softban/hackban, mod-log, filter, chat cleanup)
  • Trivia (lists are included and can be easily added)
  • Music features (YouTube, SoundCloud, local files, playlists, queues)
  • Stream alerts (Twitch, Youtube, Picarto)
  • Bank (slot machine, user credits)
  • Custom commands
  • Imgur/gif search
  • Admin automation (self-role assignment, cross-server announcements, mod-mail reports)
  • Customisable command permissions

Additionally, other plugins (cogs) can be easily found and added from our growing community of cog repositories.

Installation

The following platforms are officially supported:

If after reading the guide you are still experiencing issues, feel free to join the Official Discord Server and ask in the #support channel for help.

Plugins

Odysseia is fully modular, allowing you to load and unload plugins of your choice, and install 3rd party plugins directly from Discord! A few examples are:

  • Cleverbot integration (talk to Odysseia and she talks back)
  • Ban sync
  • Welcome messages
  • Casino
  • Reaction roles
  • Slow Mode
  • AniList
  • And much, much more!

Feel free to take a peek at a list of available 3rd party cogs!

Join the community!

Odysseia is in continuous development, and it’s supported by an active community which produces new content (cogs/plugins) for everyone to enjoy. New features are constantly added. If you can’t find the cog you’re looking for, consult our guide on building your own cogs!

Join us on our Official Discord Server!

License

Released under the GNU GPL v3 license.

Artwork created by Sinlaire on Deviant Art for the Odysseia Discord Bot Project.

This project vendors discord.ext.menus package made by Danny Y. (Rapptz) which is distributed under MIT License. A copy of this license can be found in the discord-ext-menus.LICENSE file in the odysseia/vendored folder of this repository.

Metadata

Release files for Odysseia 0.0.1b2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Odysseia 0.0.1b2
File Size Uploaded Provenance Actions
odysseia-0.0.1b2.tar.gz 4.5 MB Without provenance Details for odysseia-0.0.1b2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for Odysseia 0.0.1b2
File Interpreter ABI Platform Actions
odysseia-0.0.1b2-py3-none-any.whl Python 3 none any Details for odysseia-0.0.1b2-py3-none-any.whl

Total release size: 12.4 MB

Release files / odysseia-0.0.1b2.tar.gz

Download URL odysseia-0.0.1b2.tar.gz
Size 4.5 MB
Tags Source
SHA-256 checksum
How to use checksums
38f271c76838e51f32405cec59501540ea94bcd385d5e6ac8c58ed2988efe867
BLAKE2b-256 checksum
How to use checksums
9478119b7cf0e786274b81b026e130be25dcc31d15ece972df624af702fc19a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.15

Release files / odysseia-0.0.1b2-py3-none-any.whl

Download URL odysseia-0.0.1b2-py3-none-any.whl
Size 8.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
26467f41ea3b454263ffd53f7289b6a95b6b009d7d30c72ebf16cc822e6cc3cc
BLAKE2b-256 checksum
How to use checksums
455c7598ae5ca2d3991b264621af3e5943ddef245aee0fe3cc33e30a5de28a95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.15

Security for Odysseia 0.0.1b2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page