Skip to main content

Fastdc 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. 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

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()  

# Train ai with more data
bot.custom_info_command(data_path="data.txt")

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for fastdc-1.8.tar.gz
Algorithm Hash digest
SHA256 ce0d4f6dc04279d4a00b53b93f9ba84926618eaed57e457050632d27c35db925
MD5 98fe3dddb6cc6a08d5b29457f3fa2815
BLAKE2b-256 091fa13608589ac2c8b151b3a7b5961110bb0aee71edd8f58c806c8805ff89c7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: fastdc-1.8-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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 324c1182808c04ab8b493ba273dac139616452e95f0e49a487c6ccea17f64fe1
MD5 740d9b3fd608b53b7e1da10e0d011e4f
BLAKE2b-256 57d477f962145f3e4de5237538a7ecfe1d69b21ab030890f43ed7e467c8399e1

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