📝 description

aminolightbots is a modern framework for rapid bot development on the amino platform. built on the optimized aminolightpy library, it provides developers with an intuitive api and rich toolset.

✨ key features

🚀 ease of use

• intuitive api
• minimal code for bot creation
• detailed documentation

⚙️ advanced message processing

• command and regex support
• message filtering by various criteria
• handling all content types (text, images, stickers, etc.)

🔄 extended capabilities

• multithreaded message processing
• middleware system
• convenient dialog and command chain handling

⚡️ quick start

installation

pip install aminolightbots

simple example

from aminolightbots import bot

bot = bot(email="your_email", password="your_password")

@bot.message_handler(commands=['start'])
def start_command(message):
    message.reply("👋 hi! im bot in aminolightbots")

@bot.message_handler(regexp=r'hello|hi')
def handle_greeting(message):
    message.reply(f"hi, {message.author.nickname}! 😊")

bot.start_websocket_handling()

📚 usage examples

working with commands

@bot.message_handler(commands=['help'])
def help_command(message):
    help_text = """
    🔍 available commands:
    /start - start dialog
    /help - show help
    /info - bot information
    """
    message.reply(help_text)

user dialogs

@bot.message_handler(commands=['register'])
def start_registration(message):
    bot.send_message(message.chatId, "what's your name?")
    bot.register_next_step_handler(message, process_name)

def process_name(message):
    name = message.content
    message.reply(f"nice to meet you, {name}! 🤝")

🛠 supported events

example

@bot.message_handler(func=lambda: True, content_types=["voice"])
def handle_voice(message):
    message.reply("nice voice message!")

🤝 contributing

we welcome community contributions to the project!

1. fork the repository
2. create a branch for your changes
3. make changes and create a pull request

📄 license

this project is licensed under the mit license. see the license file for details.

🔗 useful links

• documentation
• github repository
• pypi package
• support telegram