Skip to main content

A Fast Discord Bot Framework

Project description

PyPI - Version PyPI - Downloads

FastDC is a library designed to make creating Discord bots easier. FastDC has been downloaded over 2,000 times according to Pepy statistics.


Installation

Install FastDC via pip:

pip install fastdc

Quick Start

from fastdc import FastBot


"""
- Default prefix = '!'
"""
bot = FastBot(token="YOUR_DISCORD_TOKEN")

# Setup AI, You can use groq or openai

""""
- Default model for groq = 'llama-3.3-70b-versatile'
- Default model for open ai = 'gpt-3.5-turbo'
"""
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!")

# 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

"""
On this method you can give a message when bot is running. If {bot} is not included in message, the bot will use the default message

Default Message = "{bot} Ready to Use!"

"""
bot.run(message_run="si {bot} ready")

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

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.9.tar.gz (9.9 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.9-py3-none-any.whl (8.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for fastdc-1.9.tar.gz
Algorithm Hash digest
SHA256 4519f3dc66b6e01b31a4c11eb4406a9a410643d158a54ff569d8d669c6d24c0c
MD5 215137697bca57dbc1ff6a6f705af13e
BLAKE2b-256 c785f5c98fd949e8dcc850565d6ea09a20f0ec0903f11cf37b482bc92dba4554

See more details on using hashes here.

File details

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

File metadata

  • Download URL: fastdc-1.9-py3-none-any.whl
  • Upload date:
  • Size: 8.7 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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 a1d4de279c7f77feb5cb016379108597904726cfad9e8b32d24393f689f1d1c0
MD5 350bc03abc766a6c8919f13c21bad610
BLAKE2b-256 77b85c64cae03357db601ab79490d17d636c84c0a22a1ad925867d86c3fd1fc6

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