{"id":35269297,"url":"https://github.com/xxynet/kiraai","last_synced_at":"2026-05-30T06:01:02.574Z","repository":{"id":321772986,"uuid":"1087096210","full_name":"xxynet/KiraAI","owner":"xxynet","description":"KiraAI, a modular, multi-platform AI digital life that connects Large Language Models (LLMs) and various chat adapters (QQ,  Telegram...)","archived":false,"fork":false,"pushed_at":"2026-05-23T15:06:36.000Z","size":8377,"stargazers_count":56,"open_issues_count":6,"forks_count":17,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-05-23T17:05:24.046Z","etag":null,"topics":["ai","bot","chatbot","chatgpt","deepseek","llm","openclaw","qq","telegram"],"latest_commit_sha":null,"homepage":"https://docs.xuxiny.top/ncm/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xxynet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":["https://ifdian.net/a/xxynet"]}},"created_at":"2025-10-31T11:23:28.000Z","updated_at":"2026-05-22T15:50:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"44d075f3-d552-4e6f-9d4a-6538d039a516","html_url":"https://github.com/xxynet/KiraAI","commit_stats":null,"previous_names":["xxynet/kiraai"],"tags_count":84,"template":false,"template_full_name":null,"purl":"pkg:github/xxynet/KiraAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xxynet%2FKiraAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xxynet%2FKiraAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xxynet%2FKiraAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xxynet%2FKiraAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xxynet","download_url":"https://codeload.github.com/xxynet/KiraAI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xxynet%2FKiraAI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33681809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"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":["ai","bot","chatbot","chatgpt","deepseek","llm","openclaw","qq","telegram"],"created_at":"2025-12-30T11:52:46.242Z","updated_at":"2026-05-30T06:01:02.569Z","avatar_url":"https://github.com/xxynet.png","language":"Python","funding_links":["https://ifdian.net/a/xxynet"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ✨ KiraAI\n\nLight up the digital soul\n\nEnglish | [简体中文](docs/README.zh.md)\n\n[🧭 Documentation](https://docs.kira-ai.top)\n\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/) [![Releases](https://img.shields.io/github/v/release/xxynet/KiraAI)](https://github.com/xxynet/KiraAI/releases) [![Commit](https://img.shields.io/github/last-commit/xxynet/KiraAI?color=green)](https://github.com/xxynet/KiraAI/commits) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/xxynet/KiraAI) [![QQ群](https://custom-icon-badges.demolab.com/badge/QQ群-874381335-00BFFF?style=flat\u0026logo=tencent-qq)](https://qm.qq.com/q/eZBJu9wfFC) [![Discord](https://custom-icon-badges.demolab.com/badge/Discord-KiraAI-00BFFF?style=flat\u0026logo=icons8-discord-48)](https://discord.gg/mRNmVmFHn3)\n\n\u003c/div\u003e\n\nKiraAI, a modular, multi-platform AI digital life that connects Large Language Models (LLMs), and various chat platforms (QQ, Telegram, WeChat, Discord) with a virtual being centered architecture.\n\n## 🚀 Features\n- Optimized for anthropomorphic scenarios\n- Easy-to-use WebUI\n- Customizable LLM providers and models\n- Flexible message sending mechanism, various message elements\n- Add-ons, expand the boundarieds of AI digital life\n\n## 📷 ScreenShots\n\n![alt text](screenshots/webui-light-en.png)\n\n![alt text](screenshots/webui-dark-en.png)\n\n\u003cdetails\u003e\n\u003csummary\u003e📸 CHat screenshots\u003c/summary\u003e\n\n![alt text](screenshots/image01.jpg)\n\n![alt text](screenshots/image02.png)\n\n![alt text](screenshots/image03.png)\n\n![alt text](screenshots/image04.png)\n\n![alt text](screenshots/image05.png)\n\n![alt text](screenshots/image06.png)\n\n\u003c/details\u003e\n\n\u003e [!IMPORTANT]\n\u003e This project is in active development, and **breaking changes** may occur.\n\n## 💻 Quick Start\n\n\u003e [!NOTE]\n\u003e For other deployment options, see the [Deployment Guide](https://docs.kira-ai.top/deployment/windows.html).\n\nFirst of all, you need to have Python 3.10+ installed and in the `PATH` environment variable\n\nGo to [Releases](https://github.com/xxynet/KiraAI/releases) and download `Source code\n(zip)` from the release tagged latest\n\nExtract zip and run `scripts/run.bat` on Windows or run `scripts/run.sh` on Linux or Mac\n\n## 🧪 Development Guide\n\n\u003cdetails\u003e\n\u003csummary\u003eToggle Development Guide\u003c/summary\u003e\n\n## 📦 Requirements\n- Python 3.10+\n- Node.js 18+ and npm (required to build the WebUI admin panel)\n- Windows, macOS, or Linux\n\n## 🛠️ Setup\n1. Clone this repository.\n2. Enter KiraAI folder\n\n## 🎨 Build the WebUI\nThe admin panel is a Vue 3 + Vite single-page app. Build it once before first run:\n\n```bash\ncd webui/frontend\nnpm install\nnpm run build\n```\n\nThe Vite build emits to `webui/static/dist/`. At startup, the backend checks for the matching frontend dist in `data/dist/` — if missing or outdated, it automatically downloads the pre-built bundle from GitHub Releases. The backend returns HTTP 503 at `/` if no dist is available.\n\nFor frontend development with hot-reload, run `npm run dev` in the same directory (Vite dev server on `:3000`, proxies `/api` and `/sticker` to the Python backend on `:5267`).\n\nTo use your local build instead of the downloaded one, pass `--webui-dir` and optionally skip the version check:\n\n```bash\npython main.py --webui-dir webui/static/dist --ignore-webui-version-check\n```\n\nRe-run `npm run build` after pulling frontend changes.\n\n## ▶️ Run\nYou can start KiraAI via (venv):\n- Batch script: `scripts\\run.bat`\n- Linux script: `scripts/run.sh` (make executable first)\n\nMake Linux script executable and run:\n```bash\nchmod +x scripts/run.sh\nscripts/run.sh\n```\n\n\u003c/details\u003e\n\n## ⚙️ Configuration\nRun the project \u0026 enter webui to configure:\n- Providers\n- Adapters\n- Persona\n...\n\n## 🗂️ Project Structure\n\n\u003cdetails\u003e\n\u003csummary\u003eToggle Project Structure\u003c/summary\u003e\n\n```\nKiraAI/\n  core/               # Core modules\n    adapter/           # Chat platform adapters\n    agent/             # Agent executor, MCP \u0026 skill management\n    chat/              # Session management \u0026 message handling\n    config/            # Configuration loading \u0026 field definitions\n    db/                # Database management \u0026 models\n    persona/           # Persona management\n    plugin/            # Plugin system\n    prompts/           # Prompt templates\n    provider/          # LLM provider management\n    statistics/        # Statistics module\n    tag/               # Tag system\n    telemetry/         # Telemetry module\n    utils/             # Common utilities\n    workflow/          # Workflow system\n  data/               # Memory, stickers, configs, plugin data\n  docs/               # Documentation\n  scripts/            # Launch scripts\n  screenshots/        # Screenshots\n  webui/              # WebUI backend \u0026 frontend\n  main.py             # Main launcher\n```\n\n\u003c/details\u003e\n\n## ✨ Star History\n[![Star History Chart](https://api.star-history.com/svg?repos=xxynet/KiraAI\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#xxynet/KiraAI\u0026type=date\u0026legend=top-left)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxxynet%2Fkiraai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxxynet%2Fkiraai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxxynet%2Fkiraai/lists"}