Skip to main content

A highly customisable Discord bot

Project description


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

OverviewInstallationDocumentationPluginsCommunityLicense

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

odysseia-0.0.1b1.tar.gz (4.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

odysseia-0.0.1b1-py3-none-any.whl (8.0 MB view details)

Uploaded Python 3

File details

Details for the file odysseia-0.0.1b1.tar.gz.

File metadata

  • Download URL: odysseia-0.0.1b1.tar.gz
  • Upload date:
  • Size: 4.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for odysseia-0.0.1b1.tar.gz
Algorithm Hash digest
SHA256 73b1cc51b3c2472b9f4309783a028373683ad69f6a9ab9a1d86eb8dfb4bf36b8
MD5 bc575578fbcece0e55967a776319b5e7
BLAKE2b-256 fd285e90a24ef1840b6906614ac195d21265b9186c023e84bfa2a8d983712206

See more details on using hashes here.

File details

Details for the file odysseia-0.0.1b1-py3-none-any.whl.

File metadata

  • Download URL: odysseia-0.0.1b1-py3-none-any.whl
  • Upload date:
  • Size: 8.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for odysseia-0.0.1b1-py3-none-any.whl
Algorithm Hash digest
SHA256 f281e10abc50ac2393230752170d718571d60cf35daebf6dae4d3a0334e605d2
MD5 641838b2395f1c6ec25ca60b5616cb0a
BLAKE2b-256 ab2f638698e415e908d9ec560a95caa53a2a631c9585ebd05a9a33c2593bba0e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page