https://github.com/tandemdude/hikari-lightbulb
Simple, elegant and powerful command handler for the Python Discord library, Hikari.
https://github.com/tandemdude/hikari-lightbulb
api-wrapper bot command-handler discord discord-api discord-bot hikari python python-3
Last synced: 1 day ago
JSON representation
Simple, elegant and powerful command handler for the Python Discord library, Hikari.
- Host: GitHub
- URL: https://github.com/tandemdude/hikari-lightbulb
- Owner: tandemdude
- License: mit
- Created: 2020-11-26T15:56:37.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-04-11T23:21:35.000Z (4 days ago)
- Last Synced: 2025-04-12T14:56:27.933Z (3 days ago)
- Topics: api-wrapper, bot, command-handler, discord, discord-api, discord-bot, hikari, python, python-3
- Language: Python
- Homepage: https://hikari-lightbulb.readthedocs.io/en/latest/
- Size: 6.93 MB
- Stars: 204
- Watchers: 2
- Forks: 30
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-discord - hikari-lightbulb - The official unofficial command handler for the Python discord API wrapper library, Hikari. (Misc Resources)
README
> [!NOTE]
> This branch is for Lightbulb **version 3**. If you are looking for the V2 code you should switch to the `v2` branch instead.
[](https://pypi.org/project/hikari-lightbulb)
# Overview
Lightbulb is designed to be an easy-to-use command handler library that integrates with the
Discord API wrapper library for Python, Hikari.
This library aims to make it simple for you to make your own Discord bots and provide
all the utilities and functions you need to help make this job easier.
## Installation
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install Lightbulb.
```bash
pip install --pre hikari-lightbulb
```
## Usage
```python
# Import the libraries
import hikari
import lightbulb
# Create a GatewayBot instance
bot = hikari.GatewayBot("your_token_here")
client = lightbulb.client_from_app(bot)
# Ensure the client starts once the bot is run
bot.subscribe(hikari.StartingEvent, client.start)
# Register the command with the client
@client.register()
class Ping(
# Command type - builtins include SlashCommand, UserCommand, and MessageCommand
lightbulb.SlashCommand,
# Command declaration parameters
name="ping",
description="checks the bot is alive",
):
# Define the command's invocation method. This method must take the context as the first
# argument (excluding self) which contains information about the command invocation.
@lightbulb.invoke
async def invoke(self, ctx: lightbulb.Context) -> None:
# Send a message to the channel the command was used in
await ctx.respond("Pong!")
# Run the bot
# Note that this is blocking meaning no code after this line will run
# until the bot is shut off
bot.run()
```
## Issues
If you find any bugs, issues, or unexpected behaviour while using the library,
you should open an issue with details of the problem and how to reproduce if possible.
Please also open an issue for any new features you would like to see added.
## Contributing
Pull requests are welcome. For major changes, please open an issue/discussion first to discuss what you would like to change.
Please try to ensure that documentation is updated if you add any features accessible through the public API.
If you use this library and like it, feel free to sign up to GitHub and star the project,
it is greatly appreciated and lets me know that I'm going in the right direction!
## Links
- **License:** [MIT](https://choosealicense.com/licenses/mit/)
- **Repository:** [GitHub](https://github.com/tandemdude/hikari-lightbulb)
- **Documentation:** [ReadTheDocs](https://hikari-lightbulb.readthedocs.io/en/latest/)
## IDE Plugin
Lightbulb now has a plugin for IntelliJ-based IDEs (IntelliJ, Pycharm, etc) to help improve the developer experience
by providing autocompletion and type checking not yet supported by other tools. More features such as command
boilerplate generation and further code inspections are planned.
You can install the plugin from the Jetbrains Marketplace within your IDE. View the plugin
[here](https://plugins.jetbrains.com/plugin/24669-hikari-lightbulb-support).