Skip to main content

is a library designed to make creating Discord bots easier.

Project description

PyPI - Version PyPI - Downloads

FastDC is a library designed to make creating Discord bots easier.


Installation

Install FastDC via pip:

pip install fastdc

Quick Start

from fastdc import FastBot

bot = FastBot(token="YOUR_DISCORD_TOKEN")

# Setup AI, You can use groq or openai
bot.add_ai_provider("groq", "YOUR_GROQ_API_KEY")
bot.add_ai_provider("openai", "YOUR_OPENAI_API_KEY")

# Enable AI 
bot.ai_chat(provider="groq")  # or u can use openai

# Setup command categories and help system
bot.setup_command_categories()

# Add moderation commands
bot.add_moderation_commands()

# Add utility commands
bot.add_utility_commands()

# Setup event logging
bot.setup_event_logging()

# Auto-reply
bot.auto_reply(trigger="hi", response="Hello!")

# Train the bot from a local file
bot.train_bot()  

# Trivia bot from json
bot.trivia_game(json_path="questions.json")

# Welcome and leave notifications
"""
If {member} is not included in the message, the bot will use the default welcome message.

Default Welcome Message = "Hello {member}, welcome to Server!"
Default Leave Message = "{member} has left the server"
"""
bot.welcome_member(message="Helloww, welcome {member}")
bot.leave_member(message="Goodbye {member}")

# Run the bot
bot.run()

Discord Commands

AI Commands

Command Description
!ai {prompt} Interact with AI using configured provider (Groq/OpenAI)
!askbot {question} Ask a question based on trained data

Games

Command Description
!trivia Start trivia game
!trivia_score Show trivia score
!trivia_leaderboard Show trivia leaderboard

Moderation

Command Description
!kick @user [reason] Kick a user from the server
!ban @user [reason] Ban a user from the server
!clear [amount] Clear specified number of messages

Utility

Command Description
!ping Check bot latency
!serverinfo Display server information
!bothelp Show help menu with all commands

Discord Bot Token Setup

To create your bot, follow these steps:

  1. Go to the Discord Developer Portal.
  2. Create a new application and add a bot.
  3. Enable all Privileged Gateway Intents.

AI Integration

FastDC supports multiple AI providers:

Groq

OpenAI


Training Your Bot

The train_bot() method allows your bot to respond based on your own dataset.
Simply create a file named data_train.txt in your project root with Q&A pairs.

Example format:

What is FastDC?
FastDC is a Python library for creating Discord bots quickly.

Member Join & Leave Events

Welcome and leave message

bot.welcome_member()
bot.leave_member()

Event Logging

FastDC includes a built-in logging system that tracks:

  • Command usage
  • Errors and exceptions
  • Bot events
  • AI interactions

Logs are formatted and can be easily integrated with your preferred logging system.


Note :

  • This project will be updated regularly with new features and improvements

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

fastdc-1.6.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

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

fastdc-1.6-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file fastdc-1.6.tar.gz.

File metadata

  • Download URL: fastdc-1.6.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for fastdc-1.6.tar.gz
Algorithm Hash digest
SHA256 b9b9d55e36dc6f3e97016f5bc9259a5c00180f5faa37f585ecd68ac670f4cc9e
MD5 4481f74dcb60a7ffa2b6e8cd21ff8eb6
BLAKE2b-256 93475c26d7e6d5374cfec15f9e738d6467276329dbe9587ce2a99d905c6dc538

See more details on using hashes here.

File details

Details for the file fastdc-1.6-py3-none-any.whl.

File metadata

  • Download URL: fastdc-1.6-py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for fastdc-1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b798293baebe25fa54f90a83c7af97d06437adc17a597d964186d0eeedda9d3e
MD5 e85fa4bd879e6ce300f4ac6aa9292dfc
BLAKE2b-256 feff806b2c549ffec0ccfdb9eaa69dfe3543a612a9c987e4ae9a213c7338a3a8

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