{"id":30946437,"url":"https://github.com/harukayamamoto0/alcyone","last_synced_at":"2026-04-16T01:33:30.334Z","repository":{"id":314045519,"uuid":"1053907034","full_name":"HarukaYamamoto0/alcyone","owner":"HarukaYamamoto0","description":"Alcyone is a Discord bot designed to be as complete, stable, and customizable as possible—offering automation, moderation, and fun in an integrated and reliable way.","archived":false,"fork":false,"pushed_at":"2025-11-07T07:11:38.000Z","size":146,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-07T09:09:12.431Z","etag":null,"topics":["alcyone","bot","discord","portfolio","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HarukaYamamoto0.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-10T05:23:02.000Z","updated_at":"2025-11-07T07:11:41.000Z","dependencies_parsed_at":"2025-10-09T07:07:54.785Z","dependency_job_id":"0e7773ca-11a9-4b56-9df3-f4fec7b4ce05","html_url":"https://github.com/HarukaYamamoto0/alcyone","commit_stats":null,"previous_names":["harukayamamoto0/alcyone"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HarukaYamamoto0/alcyone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaYamamoto0%2Falcyone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaYamamoto0%2Falcyone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaYamamoto0%2Falcyone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaYamamoto0%2Falcyone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HarukaYamamoto0","download_url":"https://codeload.github.com/HarukaYamamoto0/alcyone/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaYamamoto0%2Falcyone/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: 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":["alcyone","bot","discord","portfolio","typescript"],"created_at":"2025-09-11T00:49:52.754Z","updated_at":"2026-04-16T01:33:30.322Z","avatar_url":"https://github.com/HarukaYamamoto0.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🌌 **Alcyone**\n### _A modular Discord bot core forged in order, silence, and a whisper of chaos._\n\n\u003cbr\u003e\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-6f42c1?style=flat-square)](LICENSE)\n[![TypeScript](https://img.shields.io/badge/Written_in-TypeScript-3178c6?style=flat-square)]()\n[![Bun](https://img.shields.io/badge/Powered_by-Bun-000000?style=flat-square\u0026logo=bun)]()\n[![Status](https://img.shields.io/badge/Status-Active-44cc11?style=flat-square)]()\n\n\u003e “In every system, there must be structure.  \n\u003e In every structure, a pulse.”  \n\u003e — *Alcyone Core Protocol*\n\n\u003c/div\u003e\n\n## ✨ **Overview**\n\n**Alcyone** is not just another Discord bot —  \nit is a **framework**, a **foundation**, and a **core system** built for developers who want clarity and power without sacrificing elegance.\n\nDesigned with:\n\n- 🔧 **True Modularity** — commands, events, loaders and interfaces fully isolated  \n- ⚡ **High Performance** — Bun runtime + optimized loading  \n- 🧩 **Extensibility First** — structure ready for scaling, theming and customization  \n- 🔐 **Secure Integrations** — powered by Infisical and strict environment validation  \n- 🖤 **Aesthetic + Order** — code that looks clean, feels clean, and _stays_ clean\n\nUse Alcyone as:\n- a complete bot,\n- a boilerplate for new bots,\n- or the baseline for your own SDK.\n\n## 🌒 **Why Alcyone Exists**\n\n\nDiscord bots often fall into two extremes:\n\n- total chaos,\n- or unnecessary complexity.\n\nAlcyone is born in the perfect middle ground:\nA solid core, simple to understand, hard to crack — and elegant enough for you to be proud to keep.\n\n## 🧱 **Project Structure**\n\n```bash\nsrc/\n│\n├── core/               # Client, gateway, initialization\n├── commands/           # Slash, context and utilities\n│   ├── slash/\n│   ├── context/\n│   └── ...\n│\n├── events/             # Bot events (ready, interactions)\n├── loaders/            # Automatic loaders (commands, events)\n├── config/             # Constants, emojis, API keys, env validators\n├── interfaces/         # Base classes \u0026 TypeScript contracts\n├── utils/              # Helpers and safe utilities\n└── main.ts             # Entry point\n````\n\n**No manual wiring.**\nEvery command and event is detected and registered automatically.\n\n## ⚙️ **Tech Stack**\n\n| Component       | Technology        |\n| --------------- | ----------------- |\n| Runtime         | Bun               |\n| API Layer       | Discord.js v14    |\n| Language        | TypeScript        |\n| Formatting      | ESLint + Prettier |\n| HTTP Client     | Axios             |\n| Date Utils      | Moment.js         |\n| Secrets Manager | Infisical         |\n\n## 🚀 **Running the Project**\n\n### ✅ Install dependencies\n\n```bash\nbun install\n```\n\n### ✅ Login to Infisical\n\n```bash\ninfisical login\n```\n\n### ✅ Development mode\n\n```bash\nbun run dev\n```\n\n### ✅ Production build\n\n```bash\nbun run build\n```\n\n## 🧩 **Command Design**\n\nAll Slash Commands extend the unified base class:\n\n```ts\nclass Ping extends BaseSlashCommand {\n  constructor() {\n    super();\n    this\n      .setName('ping')\n      .setDescription('Shows bot and server latency with style');\n  }\n\n  async execute(interaction) {\n    await interaction.reply('Pong');\n  }\n}\n\nexport default Ping;\n```\n\nThis ensures:\n\n* predictable behavior,\n* automatic loading,\n* shared metadata,\n* easier maintenance.\n\nEvents follow the same architecture.\n\n## 🧠 **Core Philosophy**\n\n\u003e *“Simplicity is not the absence of complexity,\n\u003e but the mastery of it.”*\n\nEvery piece of Alcyone is built with:\n\n* low coupling,\n* clear responsibilities,\n* and minimal side-effects.\n\nIt is the exact opposite de um bot “gigante e bagunçado”.\n\n## 📜 License\n\nDistributed under the **Apache 2.0 License**.\nSee [`LICENSE`](LICENSE) for details.\n\n\u003cdiv align=\"center\"\u003e\n\n### 🖤 Alcyone\n\n**Built by [HarukaYamamoto0](https://github.com/HarukaYamamoto0)**\nwith elegance, caffeine, and the gentle fear of breaking production.\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharukayamamoto0%2Falcyone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharukayamamoto0%2Falcyone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharukayamamoto0%2Falcyone/lists"}