{"id":31381642,"url":"https://github.com/alirezabhd/nakisa","last_synced_at":"2026-04-18T11:02:49.274Z","repository":{"id":310195149,"uuid":"1024872299","full_name":"AlirezaBHD/Nakisa","owner":"AlirezaBHD","description":"Nakisa is a Telegram bot that builds structured music communities around playlists.","archived":false,"fork":false,"pushed_at":"2025-09-18T09:37:42.000Z","size":204,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-09-18T11:41:52.872Z","etag":null,"topics":["aspnet-core","community","csharp","discovery","dotnet-core","music-playlist","open-source","promotion","social-media","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/NakisaMusicBot","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlirezaBHD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-07-23T11:25:17.000Z","updated_at":"2025-09-18T09:37:45.000Z","dependencies_parsed_at":"2025-09-08T19:04:34.468Z","dependency_job_id":"1637b568-2c6f-4283-9d26-e4f0e0dc7e01","html_url":"https://github.com/AlirezaBHD/Nakisa","commit_stats":null,"previous_names":["alirezabhd/nakisa"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AlirezaBHD/Nakisa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlirezaBHD%2FNakisa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlirezaBHD%2FNakisa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlirezaBHD%2FNakisa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlirezaBHD%2FNakisa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlirezaBHD","download_url":"https://codeload.github.com/AlirezaBHD/Nakisa/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlirezaBHD%2FNakisa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277359048,"owners_count":25804804,"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-09-28T02:00:08.834Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["aspnet-core","community","csharp","discovery","dotnet-core","music-playlist","open-source","promotion","social-media","telegram-bot"],"created_at":"2025-09-28T10:39:36.129Z","updated_at":"2026-04-18T11:02:49.267Z","avatar_url":"https://github.com/AlirezaBHD.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1280\" height=\"720\" alt=\"cover\" src=\"https://github.com/user-attachments/assets/254d66bd-de85-4228-86c4-0d14d138794a\" /\u003e\n\n**Nakisa** is a Telegram bot that builds structured music communities around playlists.  \nUsers can join categorized playlists, share songs, promote their channels, and connect with people who share the same music taste.  \n  \n---\n\n## 🚀 Features\n\n- 🔹 User registration via Telegram\n- 🔹 Join categorized playlists\n- 🔹 Submit songs and mention your Telegram ID or channel\n- 🔹 React to songs shared by others\n- 🔹 Community-driven channel promotion\n- 🔹 Discover and connect with people who share your music taste\n\n---\n\n## 🛠 Tech Stack\n\n- **.NET 9** (ASP.NET Core, Clean Architecture)\n- **PostgreSQL** as the database\n- **Entity Framework Core** for ORM and migrations\n- **Telegram Bot API**\n- Clean Architecture with the following layers:\n  - `API`\n  - `Application`\n  - `Domain`\n  - `Infrastructure`\n  - `Persistence`\n  - `SharedKernel`\n  - `Tests`\n\n---\n\n## ⚡ Getting Started\n\n### 1️⃣ Clone the repository\n\n```bash\ngit clone https://github.com/AlirezaBHD/Nakisa.git\ncd Nakisa\n```\n\n### 2️⃣ Configure environment variables\nCreate a `.env` file (or use `appsettings.json`) with:\n```\nConnectionStrings__DefaultConnection=\"Host=host;Port=5432;Database=nakisa;Username=postgres;Password=postgres\"  \nTelegramBot__Token=Your Bot Token  \nTelegramClient__ApiHash=Your Telegram Api Hash  \nTelegramClient__ApiId=Your Telegram Api Id  \nTelegramClient__PhoneNumber=+111111111111  \n```\n### 3️⃣ Run the database\n\nUsing Docker:\n\n`docker-compose up -d`\n\n### 4️⃣ Apply migrations\n\n`dotnet ef database update --project Nakisa.Persistence --startup-project Nakisa.API`\n\n### 5️⃣ Run the project\n\n`dotnet run --project Nakisa.API`\n\n---\n\n## 🤝 Contributing\n\nContributions, issues, and feature requests are welcome!  \nFeel free to check the [issues page](https://github.com/AlirezaBHD/Nakisa/issues).\n\n1. Fork it\n  \n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n  \n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n  \n4. Push to the branch (`git push origin feature/amazing-feature`)\n  \n5. Open a Pull Request\n  \n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falirezabhd%2Fnakisa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falirezabhd%2Fnakisa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falirezabhd%2Fnakisa/lists"}