{"id":21593563,"url":"https://github.com/okineadev/neko-chan-bot","last_synced_at":"2025-04-10T23:40:22.273Z","repository":{"id":221167354,"uuid":"753271511","full_name":"okineadev/neko-chan-bot","owner":"okineadev","description":"A Telegram bot with cute nekos (and not only) 😺","archived":false,"fork":false,"pushed_at":"2024-02-08T19:28:05.000Z","size":24778,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-22T14:48:14.724Z","etag":null,"topics":["aiogram","anime","art","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/MeowMatrixBot","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/okineadev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2024-02-05T19:49:07.000Z","updated_at":"2024-04-06T19:56:41.000Z","dependencies_parsed_at":"2024-02-06T15:41:31.409Z","dependency_job_id":null,"html_url":"https://github.com/okineadev/neko-chan-bot","commit_stats":null,"previous_names":["okineadev/neko-chan-bot"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okineadev%2Fneko-chan-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okineadev%2Fneko-chan-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okineadev%2Fneko-chan-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okineadev%2Fneko-chan-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/okineadev","download_url":"https://codeload.github.com/okineadev/neko-chan-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226193697,"owners_count":17588179,"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","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":["aiogram","anime","art","telegram","telegram-bot"],"created_at":"2024-11-24T17:13:32.354Z","updated_at":"2024-11-24T17:13:32.803Z","avatar_url":"https://github.com/okineadev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/okineadev/neko-chan-bot\"\u003e\n    \u003cimg src=\"public/logo.jpg\" alt=\"Logo\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003e😺 NekoChan\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A Telegram bot with cute cat girls (and not only) 😊\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/okineadev/neko-chan-bot/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/okineadev/neko-chan-bot/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## ℹ️ About The Project\n\n\u003cimg src=\"public/screenshot.png\"\u003e\u003c/img\u003e\n\nThis bot can send pictures and GIF's with nekos, kitsune .etc\n\nThis project uses [**nekosbest**](https://github.com/nekos-best/nekos-best.py) API\n\n\u003chr\u003e\n\n## 🧧 Getting Started\n\n### 📦 Prerequisites\n\n- **Git**\n- **make** (in Linux)\n- **Bash** or **cygwin-like** shell (in Windows)\n\n### 💿 Installation\n\n1. Clone the repo\n\n   ```sh\n   git clone https://github.com/okineadev/neko-chan-bot.git\n   cd neko-chan-bot\n   ```\n\n2. Install all dependencies\n   ```sh\n   make setup\n   # Or run this script if you on Windows\n   # ./setup.sh\n   ```\n\n3. Create a bot in [@BotFather](https://t.me/botfather) and copy the token.\n\n    \u003e [!TIP]\n    \u003e If you don't know how to do it, here are the [**instructions**](https://telegra.ph/How-to-create-a-Telegram-bot-with-BotFather-02-08)\n\n4. Add your bot's token to the `.env` (environment) file\n\n   ```sh\n   echo 'BOT_TOKEN=\"\u003cyour bot token\u003e\"' \u003e\u003e .env\n   ```\n\n## 🔥 Usage\n\nWrite a command to the bot with the category of photo or gif you want to receive\n\nUsage: `/\u003ccategory\u003e \u003camount\u003e`\n\nExample: `/neko`\n\nThe bot will send you one photo, to get several at the same time, write the number you want to get at the end: `/neko 8`\n\n\u003e [!NOTE]\n\u003e The maximum number of photos at a time is 10 pieces.\n\nYou can also get a **GIF** by doing the same thing as in the previous step.\n\n\u003e [!NOTE]\n\u003e You can only get one GIF at a time\n\n\u003chr/\u003e\n\nIf you want to check out all the commands, here is their list:\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eView full list\u003c/b\u003e\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003cb\u003eneko\u003c/b\u003e - Send neko 😺\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ekitsune\u003c/b\u003e - Send kitsune 🦊\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ewaifu\u003c/b\u003e - Send waifu 👩‍❤️‍👨\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ehusbando\u003c/b\u003e - Send husbando 👨‍❤️‍👨\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ebaka\u003c/b\u003e - Send baka GIF 🤦‍♂️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ebite\u003c/b\u003e - Send bite GIF 👄\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003eblush\u003c/b\u003e - Send blush GIF ☺️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ebored\u003c/b\u003e - Send bored GIF 😑\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ecry\u003c/b\u003e - Send cry GIF 😢\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ecuddle\u003c/b\u003e - Send cuddle GIF 🤗\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003edance\u003c/b\u003e - Send dance GIF 💃\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003efacepalm\u003c/b\u003e - Send facepalm GIF 🤦‍♂️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003efeed\u003c/b\u003e - Send feed GIF 🍽️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ehandhold\u003c/b\u003e - Send handhold GIF 🤝\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ehandshake\u003c/b\u003e - Send handshake GIF 🤝\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ehappy\u003c/b\u003e - Send happy GIF 😄\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ehighfive\u003c/b\u003e - Send highfive GIF 🙌\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ehug\u003c/b\u003e - Send hug GIF 🤗\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ekick\u003c/b\u003e - Send kick GIF 👟\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ekiss\u003c/b\u003e - Send kiss GIF 💋\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003elaugh\u003c/b\u003e - Send laugh GIF 😂\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003elurk\u003c/b\u003e - Send lurk GIF 🕵️‍♂️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003enod\u003c/b\u003e - Send nod GIF 👍\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003enom\u003c/b\u003e - Send nom GIF 😋\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003enope\u003c/b\u003e - Send nope GIF 🙅‍♂️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003epat\u003c/b\u003e - Send pat GIF 🤚\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003epeck\u003c/b\u003e - Send peck GIF 💏\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003epoke\u003c/b\u003e - Send poke GIF 👉\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003epout\u003c/b\u003e - Send pout GIF 😡\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003epunch\u003c/b\u003e - Send punch GIF 👊\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003eshoot\u003c/b\u003e - Send shoot GIF 🔫\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003eshrug\u003c/b\u003e - Send shrug GIF 🤷‍♂️\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003eslap\u003c/b\u003e - Send slap GIF 👋\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003esleep\u003c/b\u003e - Send sleep GIF 😴\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003esmile\u003c/b\u003e - Send smile GIF 😊\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003esmug\u003c/b\u003e - Send smug GIF 😏\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003estare\u003c/b\u003e - Send stare GIF 👀\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ethink\u003c/b\u003e - Send think GIF 🤔\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ethumbsup\u003c/b\u003e - Send thumbsup GIF 👍\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003etickle\u003c/b\u003e - Send tickle GIF 🤣\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ewave\u003c/b\u003e - Send wave GIF 👋\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003ewink\u003c/b\u003e - Send wink GIF 😉\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003eyawn\u003c/b\u003e - Send yawn GIF 😪\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003eyeet\u003c/b\u003e - Send yeet GIF 💨\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n## 📑 Additional materials\n\n### 🏞️ Photoshop designs\n\n- You can use and edit the `.psd` files located in the [**assets/photoshop**](assets/photoshop) folder\n\n- If you want to fix the logo of the repository, the avatar of the bot - you can safely take the file and edit it, after that export the photo and place it in the desired folder (for example [**public**](public))\n\n### 📄 Commands\n\n- A list of all commands is in the file [**commands_list.txt**](assets/commands_list.txt)\n- You can send it to BotFather to install a menu with all the commands\n\n## 🤝 Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📝 License\n\nDistributed under the GNU GPLv3 . See `LICENSE.txt` for more information.\n\n## ☎️ Contact\n\nTelegram - [**@Okinea**](https://t.me/okinea)\n\nIf you have any suggestions or problems, contact me.\n\n## 🍩 Support\nYou can support me financially, I will be very grateful!\n\n💳 **Bank card:** `4441 1144 0274 7206` (**monobank**)\n\n💎 **TON Wallet:** `UQBaBIBtKJpdwc4jKSGd70LZyQnEf-Nx5edzZlZAAGkHnZ7E`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fokineadev%2Fneko-chan-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fokineadev%2Fneko-chan-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fokineadev%2Fneko-chan-bot/lists"}