{"id":29708759,"url":"https://github.com/kamfretoz/pururu","last_synced_at":"2025-07-23T19:05:55.195Z","repository":{"id":54651041,"uuid":"440508523","full_name":"kamfretoz/Pururu","owner":"kamfretoz","description":"A Multi-Purpose bot written in Hikari + Lightbulb!","archived":false,"fork":false,"pushed_at":"2025-07-14T11:48:26.000Z","size":9933,"stargazers_count":19,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-14T15:00:45.297Z","etag":null,"topics":["discord","discord-bots","hikari-lightbulb","hikari-py","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kamfretoz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-21T12:25:44.000Z","updated_at":"2025-07-14T11:48:28.000Z","dependencies_parsed_at":"2023-02-13T18:32:28.771Z","dependency_job_id":"a9f905e5-5036-4b19-be7e-99a45c991d96","html_url":"https://github.com/kamfretoz/Pururu","commit_stats":null,"previous_names":["kamfretoz/pururu"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kamfretoz/Pururu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamfretoz%2FPururu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamfretoz%2FPururu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamfretoz%2FPururu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamfretoz%2FPururu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kamfretoz","download_url":"https://codeload.github.com/kamfretoz/Pururu/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamfretoz%2FPururu/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266737746,"owners_count":23976392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","discord-bots","hikari-lightbulb","hikari-py","python"],"created_at":"2025-07-23T19:05:51.429Z","updated_at":"2025-07-23T19:05:55.161Z","avatar_url":"https://github.com/kamfretoz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\u003c!--\n*** Thanks for checking out the Best-README-Template. If you have a suggestion\n*** that would make this better, please fork the repo and create a pull request\n*** or simply open an issue with the tag \"enhancement\".\n*** Don't forget to give the project a star!\n*** Thanks again! Now go create something AMAZING! :D\n--\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/kamfretoz/Pururu\"\u003e\n    \u003cimg src=\"images/Logo.png\" alt=\"Logo\" style=\"width: 25vw; min-width: 350px;\"\u003e\n  \u003c/a\u003e\n\n\u003ch1 align=\"center\"\u003ePuruBot\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    A Multi-Purpose bot written with Hikari + Lightbulb!\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eRunning The Bot\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\n\u003cp\u003e\nThis is a Multi-Purpose Bot written in Python and built with Hikari and Lightbulb. \nA project that serves as a way for me to learn Python Programming.\nFeel free to explore it by yourself!\n\u003c/p\u003e\n\n### Built With\n\n* [`hikari`](https://github.com/hikari-py/hikari) - An opinionated, static typed Discord microframework for Python3 and asyncio that supports Discord's V10 REST API and Gateway.\n* [`Lightbulb`](https://github.com/tandemdude/hikari-lightbulb/) - A flexible command framework designed to extend Hikari.\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nTo get the bot up and running, there are few steps that are need to be taken. Please follow these steps below carefully.\n\n* You will need Python \u003e= 3.8  so install it first!\n* Install `screen` with `sudo apt install screen` or `sudo pacman -S screen` depending on your distro.\n\n### Prerequisites\n\nYou will need to configure the bot with the `.env` file. This is needed to store some configuration data that are needed by the bot.\n\n* As the bot uses few publicly available API (and Discord itself!), it needs a token to access them and you will have to provide them yourself, get the keys here:\n  * [Discord](https://discord.com/developers/applications)\n  * [OpenWeatherMap](https://openweathermap.org/api)\n  * [Currency API](https://currency.getgeoapi.com/)\n  * [Spotify](https://developer.spotify.com/dashboard/)\n\n* You will also need a Lavalink nodes for music functionality. There are 2 options, either you self-host your own or you use the readily available Free Lavalink Nodes. Here are some recommendation:\n  * [Lavalink Hosting](https://lavalink.darrennathanael.com/)\n\n* Configure your `.env` as you please and put your token here.\n\n  ```sh\n  cd Pururu/\n  cp .env.example .env\n  nano .env\n  ```\n  \n  Further configuration can also be found at `utils/const.py`\n\n### Installation\n\n1. Clone the repository\n\n   ```sh\n   git clone https://github.com/kamfretoz/Pururu.git\n   cd Pururu/\n   ```\n\n2. Create a Virtual Enviroment and activate it\n\n    ```sh\n    python3 -m venv .venv\n    source .venv/bin/activate\n    ```\n\n3. Follow the steps from \u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\n\n4. Install the required dependencies\n\n   ```sh\n   python3 -m pip install -r requirements.txt\n   ```\n\n5. Run the bot\n\n   ```sh\n   chmod +x run.sh\n   ./run.sh\n   ```\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Running the bot (continued)\n\nThere are few notes in regards to run the bot:\n\n* If you'd like to run the bot (Or when you want to restart it), you will have to re-activate the Virtual Environment if you haven't done so:\n\n  ```sh\n    source .venv/bin/activate\n    ./run.sh\n  ```\n\n* After you have successfully run the bot, you will have to Minimize the \"screen\" to let the bot run in the background.\n* Press `CTRL + A, D` to Minimize the screen\n* Type in `screen -r bot` to restore the screen\n\n### Enjoy! :D\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/kamfretoz/Pururu.svg?style=for-the-badge\n[contributors-url]: https://github.com/kamfretoz/Pururu/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/kamfretoz/Pururu.svg?style=for-the-badge\n[forks-url]: https://github.com/kamfretoz/Pururu/network/members\n[stars-shield]: https://img.shields.io/github/stars/kamfretoz/Pururu.svg?style=for-the-badge\n[stars-url]: https://github.com/kamfretoz/Pururu/stargazers\n[issues-shield]: https://img.shields.io/github/issues/kamfretoz/Pururu.svg?style=for-the-badge\n[issues-url]: https://github.com/kamfretoz/Pururu/issues\n[license-shield]: https://img.shields.io/github/license/kamfretoz/Pururu.svg?style=for-the-badge\n[license-url]: https://github.com/kamfretoz/Pururu/blob/master/LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamfretoz%2Fpururu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamfretoz%2Fpururu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamfretoz%2Fpururu/lists"}