{"id":43511791,"url":"https://github.com/hypergonial/hikari-arc","last_synced_at":"2026-02-03T13:11:25.889Z","repository":{"id":214395037,"uuid":"736425637","full_name":"hypergonial/hikari-arc","owner":"hypergonial","description":"A command handler for hikari with a focus on type-safety and correctness.","archived":false,"fork":false,"pushed_at":"2025-11-13T17:47:58.000Z","size":2467,"stargazers_count":27,"open_issues_count":2,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-13T19:26:54.518Z","etag":null,"topics":["dependency-injection","discord","discord-bot","discord-bot-framework","discord-command-handler","hikari","hikari-arc","hikari-py","slash-commands"],"latest_commit_sha":null,"homepage":"https://arc.hypergonial.com/","language":"Python","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/hypergonial.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"hypergonial"}},"created_at":"2023-12-27T21:52:43.000Z","updated_at":"2025-11-13T17:48:02.000Z","dependencies_parsed_at":"2024-01-04T22:44:06.195Z","dependency_job_id":"9dfd2911-ed4d-451a-8ce1-e22e3659c84a","html_url":"https://github.com/hypergonial/hikari-arc","commit_stats":null,"previous_names":["hypergonial/hikari-arc"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/hypergonial/hikari-arc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypergonial%2Fhikari-arc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypergonial%2Fhikari-arc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypergonial%2Fhikari-arc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypergonial%2Fhikari-arc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hypergonial","download_url":"https://codeload.github.com/hypergonial/hikari-arc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypergonial%2Fhikari-arc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29046503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["dependency-injection","discord","discord-bot","discord-bot-framework","discord-command-handler","hikari","hikari-arc","hikari-py","slash-commands"],"created_at":"2026-02-03T13:11:24.285Z","updated_at":"2026-02-03T13:11:25.876Z","avatar_url":"https://github.com/hypergonial.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./docs/assets/branding/composed-darkmode.svg\"\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./docs/assets/branding/composed-lightmode.svg\"\u003e\n        \u003cimg alt=\"The arc logo\" src=\"./docs/assets/branding/composed-lightmode.svg\" width=\"30%\"\u003e\n    \u003c/picture\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n[![PyPI](https://img.shields.io/pypi/v/hikari-arc)](https://pypi.org/project/hikari-arc)\n[![CI](https://github.com/hypergonial/hikari-arc/actions/workflows/ci.yml/badge.svg)](https://github.com/hypergonial/hikari-arc/actions/workflows/ci.yml)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)\n![Pyright](https://badgen.net/badge/Pyright/strict/2A6DB2)\n\n\u003c/div\u003e\n\nA command handler for [hikari](https://github.com/hikari-py/hikari) with a focus on type-safety and correctness.\n\n## Installation\n\nTo install arc, run the following command:\n\n```sh\npip install -U hikari-arc\n```\n\nTo check if arc has successfully installed or not, run the following:\n\n```sh\npython3 -m arc\n# On Windows you may need to run:\npy -m arc\n```\n\n\u003e [!NOTE]\n\u003e `hikari-arc` requires a Python version of *at least* 3.10.\n\nIf you're just getting started, you may also use the [template repository](https://github.com/hypergonial/arc-template) to get started with.\n\n## Basic Usage\n\n```py\nimport hikari\nimport arc\n\nbot = hikari.GatewayBot(\"TOKEN\") # or hikari.RESTBot\nclient = arc.GatewayClient(bot) # or arc.RESTClient\n\n@client.include\n@arc.slash_command(\"hi\", \"Say hi!\")\nasync def ping(\n    ctx: arc.GatewayContext,\n    user: arc.Option[hikari.User, arc.UserParams(\"The user to say hi to.\")]\n) -\u003e None:\n    await ctx.respond(f\"Hey {user.mention}!\")\n\nbot.run()\n```\n\nTo get started with `arc`, see the [documentation](https://arc.hypergonial.com), or the [examples](https://github.com/hypergonial/hikari-arc/tree/main/examples).\n\n## Issues and support\n\nFor general usage help or questions, see the [hikari discord](https://discord.gg/hikari), if you have found a bug or have a feature request, feel free to [open an issue](https://github.com/hypergonial/hikari-arc/issues/new/choose)!\n\n## Contributing\n\nSee [Contributing](./CONTRIBUTING.md).\n\n## Acknowledgements\n\n`arc` is in large part a combination of all the parts I like in other command handlers, with my own spin on it. The following projects have inspired me and aided me greatly in the design of this library:\n\n- [`hikari-lightbulb`](https://github.com/tandemdude/hikari-lightbulb) - The library initially started as a reimagination of lightbulb, it inherits a similar project structure and terminology.\n- [`Tanjun`](https://github.com/FasterSpeeding/Tanjun) - For the idea of using `typing.Annotated` and [dependency injection](https://arc.hypergonial.com/guides/dependency_injection/) in a command handler. `arc` also uses the same dependency injection library, [`Alluka`](https://github.com/FasterSpeeding/Alluka), under the hood.\n- [`hikari-crescent`](https://github.com/hikari-crescent/hikari-crescent) The design of [hooks](https://arc.hypergonial.com/guides/hooks/) is largely inspired by `crescent`.\n- [`FastAPI`](https://github.com/tiangolo/fastapi) - Some design ideas and most of the [documentation](https://arc.hypergonial.com/) [configuration](https://github.com/hypergonial/hikari-arc/blob/main/mkdocs.yml) derives from `FastAPI`.\n- The `arc` logo was made by [@PythonTryHard](https://github.com/PythonTryHard).\n\n\n## Links\n\n- [**Documentation**](https://arc.hypergonial.com)\n- [**Examples**](https://github.com/hypergonial/hikari-arc/tree/main/examples)\n- [**License**](https://github.com/hypergonial/hikari-arc/blob/main/LICENSE)\n","funding_links":["https://github.com/sponsors/hypergonial"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypergonial%2Fhikari-arc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypergonial%2Fhikari-arc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypergonial%2Fhikari-arc/lists"}