{"id":13306300,"url":"https://github.com/rtnl/kitten","last_synced_at":"2025-03-10T14:32:29.351Z","repository":{"id":178653483,"uuid":"603338447","full_name":"GeniusHQ/kitten","owner":"GeniusHQ","description":"Chat bot framework in V","archived":false,"fork":false,"pushed_at":"2023-07-05T19:46:14.000Z","size":84,"stargazers_count":13,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-08-04T01:04:28.071Z","etag":null,"topics":["bot","discord","discord-api","discord-bot","guilded","guilded-api","guilded-bot","v","vlang"],"latest_commit_sha":null,"homepage":"","language":"V","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GeniusHQ.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}},"created_at":"2023-02-18T07:47:44.000Z","updated_at":"2023-10-31T03:49:06.000Z","dependencies_parsed_at":"2024-01-27T09:38:33.204Z","dependency_job_id":"cc18d173-7b86-4170-8862-0c254a00dafe","html_url":"https://github.com/GeniusHQ/kitten","commit_stats":null,"previous_names":["geniushq/kitten"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeniusHQ%2Fkitten","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeniusHQ%2Fkitten/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeniusHQ%2Fkitten/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeniusHQ%2Fkitten/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GeniusHQ","download_url":"https://codeload.github.com/GeniusHQ/kitten/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221180049,"owners_count":16770698,"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":["bot","discord","discord-api","discord-bot","guilded","guilded-api","guilded-bot","v","vlang"],"created_at":"2024-07-29T17:57:12.648Z","updated_at":"2025-03-10T14:32:23.946Z","avatar_url":"https://github.com/GeniusHQ.png","language":"V","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg style=\"width: 128px; height: 128px\" src=\"https://media.githubusercontent.com/media/GeniusHQ/kitten/main/kitten.png\" alt=\"icon\"\u003e\n  \u003ch1 style=\"margin: auto\"\u003eKitten\u003c/h1\u003e\n\n  \u003cp\u003eAn experimental API for making chat bots in V\u003c/p\u003e\n\n  [![vlang](https://img.shields.io/badge/Made%20with-V-536b8a)](https://vlang.io)\n  [![discord](https://discord.com/api/guilds/1066528514179874816/embed.png)](https://discord.gg/AXPHVgTTCR)\n\u003c/div\u003e\n\n## Project State\n\nAs presented in the title, this project is still in its initial stages. This document will describe the project closer to its design than its available content. Kitten is not production safe. Currently, the bot tends to crash by itself after a few hours. The official documentation will be more accurate for real use in your project. In order to keep Kitten's development going, the Genius team has decided to use this as the main library for the Genius bot. Anything Genius does in regards of the APIs will be feasible with Kitten, and... contributions are always welcome!\n\n## Features\n\n### Multi-platform Support\n\nKitten allows developers to simultaneously listen to multiple chat applications. Deploying to Discord+Guilded for example is as easy as just to Discord.\n\n### Rich Abstractions\n\nUnlike libraries such as discordgo, Kitten is provided with a variety of abstractions to empower the users' productivity without sacrificing control. We believe that chatbots can be very complex projects and therefore it's often a good idea to present more than one way of getting something done.\n\n### API Compliance\n\nKitten makes its best efforts to respect API requirements and ratelimits. Developers should never get ratelimited thanks to the client-side caching mechanisms.\n\n### Safe and Efficient\n\nKitten has been written in the V programming langauge. So we can expect performance that is on par with C/C++; all while enjoying safe and modern language features that come with a simple (Go-like) syntax. V binaries are compact and generally don't require the language toolchain to be installed on the host. The average bot instance will use no more than a few megabytes of memory, making this ideal for running on micro computers such as Raspberry Pi's.\n\n## Installation\n\nTo use Kitten in your V project, simply install it with\n\n```sh\nv install \"https://github.com/geniushq/kitten\"\n```\n\n\n## Example\n\n```v\nmodule main\n\nimport os\n\nimport kitten\nimport kitten.universe\nimport kitten.discord.intents\n\nfn handle_ready(mut client kitten.Client) ! {\n    println('Ready')\n}\n\n// This will reply to Discord and Guilded \"!ping\" messages\nfn handle_message(mut client kitten.Client, message \u0026universe.Message) ! {\n\tif message.content.to_lower() == \"!ping\" {\n\t\tclient.universe_channel_message_send(message.platform, message.channel, \"pong\")!\n\t}\n}\n\nfn main() {\n    mut client := kitten.new_client()\n\t\n    client.with_discord(\n        os.getenv(\"DISCORD_TOKEN\"),\n        intents.guild_messages | intents.message_content)\n\t\t\n    client.with_guilded(\n        os.getenv(\"GUILDED_TOKEN\"))\n\n    client.universe_on_ready(handle_ready)\n    client.universe_on_message_create(handle_message)\n\n    client.start()!\n    client.wait()!\n}\n\n```\n\nMore examples can be found [here](https://github.com/geniushq/kitten/tree/main/examples)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frtnl%2Fkitten","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frtnl%2Fkitten","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frtnl%2Fkitten/lists"}