{"id":45154651,"url":"https://github.com/astrbotdevs/astrbot-desktop","last_synced_at":"2026-04-11T17:08:34.700Z","repository":{"id":339355026,"uuid":"1161409654","full_name":"AstrBotDevs/AstrBot-desktop","owner":"AstrBotDevs","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-19T14:01:46.000Z","size":243,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-19T14:22:04.863Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/AstrBotDevs.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":"2026-02-19T04:25:10.000Z","updated_at":"2026-02-19T14:02:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AstrBotDevs/AstrBot-desktop","commit_stats":null,"previous_names":["astrbotdevs/astrbot-desktop"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AstrBotDevs/AstrBot-desktop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot-desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot-desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot-desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot-desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AstrBotDevs","download_url":"https://codeload.github.com/AstrBotDevs/AstrBot-desktop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstrBotDevs%2FAstrBot-desktop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29640861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T03:21:14.183Z","status":"ssl_error","status_checked_at":"2026-02-20T03:18:24.455Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":[],"created_at":"2026-02-20T04:02:11.339Z","updated_at":"2026-04-11T17:08:34.693Z","avatar_url":"https://github.com/AstrBotDevs.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)\n\n\u003cdiv align=\"center\"\u003e\n\nEnglish ｜ \u003ca href=\"./README_zh.md\"\u003e简体中文\u003c/a\u003e\n\n# AstrBot Desktop\n\nThe desktop edition of AstrBot, designed for fast local installation and convenient access to ChatUI and plugins.\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/AstrBotDevs/AstrBot\"\u003eUpstream AstrBot\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n  \u003ca href=\"https://astrbot.app/\"\u003eDocumentation\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n  \u003ca href=\"https://github.com/AstrBotDevs/AstrBot-desktop/releases/latest\"\u003eReleases\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n  \u003ca href=\"https://github.com/AstrBotDevs/AstrBot-desktop/issues\"\u003eIssue Tracker\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003cdiv\u003e\n\u003cimg src=\"https://img.shields.io/github/v/release/AstrBotDevs/AstrBot-desktop?color=76bad9\" alt=\"Latest release\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Tauri-2.10.0-24C8D8?logo=tauri\u0026logoColor=white\" alt=\"Tauri 2.10.0\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Runtime-CPython%203.12-blue\" alt=\"CPython 3.12\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Upstream-AstrBotDevs%2FAstrBot-181717?logo=github\" alt=\"AstrBotDevs/AstrBot\"\u003e\n\u003c/div\u003e\n\n\u003c/div\u003e\n\nAstrBot Desktop is a packaged desktop distribution of AstrBot for local use. It bundles the WebUI, backend runtime, and desktop shell into a single app, making it a good fit for users who want a quick local setup with ChatUI, plugins, and knowledge base features. If you plan to run AstrBot on a server for long-term use, the upstream AstrBot source, Docker, or panel-based deployment is still the better choice.\n\n\u003c!-- section: best-fit --\u003e\n## Best Fit For\n\n- You want to install AstrBot directly on Windows, macOS, or Linux without preparing a full command-line environment first.\n- You mainly use ChatUI, the plugin marketplace, and the knowledge base on your local machine.\n- You want your data stored in a local directory for easier backup, migration, and troubleshooting.\n- You need both `stable` and `nightly` release channels for daily use or early access testing.\n\n\u003c!-- section: highlights --\u003e\n## Highlights\n\n1. Ready-to-use desktop installation experience with the WebUI and backend runtime included by default.\n2. Compatible with the upstream AstrBot ecosystem for local ChatUI, plugins, and common workflows.\n3. Uses an isolated local data directory by default, making configuration, plugins, and logs easier to manage.\n4. Provides both `stable` and `nightly` channels for stable usage or early access to recent changes.\n5. Supports migration to source-based deployment, and migration back from source deployment to the desktop app.\n\n\u003c!-- section: one-click-install --\u003e\n## One-Click Install\n\nIf you only want to use the app and do not need to build it locally, download the installer for your platform from [`Releases`](https://github.com/AstrBotDevs/AstrBot-desktop/releases/latest).\n\n- [Stable](https://github.com/AstrBotDevs/AstrBot-desktop/releases/latest): recommended for most users.\n- [Nightly](https://github.com/AstrBotDevs/AstrBot-desktop/releases/tag/nightly): automatically built from newer upstream changes for early access to fixes and features.\n- Choose the package that matches your operating system and CPU architecture.\n\n\u003c!-- section: data-and-configuration-location --\u003e\n## Data and Configuration Location\n\nAstrBot Desktop stores the AstrBot root directory under the user home directory as `.astrbot` by default:\n\n- macOS / Linux: `~/.astrbot`\n- Windows: `C:\\Users\\\u003cusername\u003e\\.astrbot`\n\nCommon directories:\n\n| Path | Description |\n| --- | --- |\n| `data/config/` | Configuration files |\n| `data/plugins/` | Plugins |\n| `data/plugin_data/` | Plugin data |\n| `data/knowledge_base/` | Knowledge base data |\n| `data/webchat/` | WebChat-related data |\n| `logs/` | Desktop and backend logs |\n\nIf you need to migrate data between the desktop app and a source-based deployment, read [`docs/data-migration.md`](docs/data-migration.md) first.\n\n\u003c!-- section: updates-and-release-channels --\u003e\n## Updates and Release Channels\n\n- `stable`: recommended for everyday use.\n- `nightly`: closer to the latest upstream commits, suitable for testing new features or fixes.\n- On Windows, macOS, and Linux AppImage builds, the desktop updater usually works directly in-app. Some Linux installation methods may still require manual download and installation.\n\n\u003c!-- section: faq --\u003e\n## FAQ\n\n\u003c!-- faq: server-deployment --\u003e\n### Is it suitable for server deployment?\n\nNot really. AstrBot Desktop is intended for local desktop usage and personal workflows. If you need long-running, stable server deployment, use the upstream AstrBot source, Docker, or panel-based deployment instead.\n\n\u003c!-- faq: macos-quarantine --\u003e\n### macOS says the app is damaged or cannot be opened\n\nIf you downloaded the installer from the internet, macOS may attach a quarantine flag to the app. Run:\n\n```bash\nxattr -dr com.apple.quarantine /Applications/AstrBot.app\n```\n\nThen restart the app. If the app is not located in `/Applications`, replace the path with the actual one.\n\n\u003c!-- faq: missing-runtime-tools --\u003e\n### Why do some MCP tools say `node`, `npx`, or `uvx` is missing?\n\nSome MCP tools depend on `node`, `npx`, or `uvx` from your system environment. These dependencies are not bundled with the desktop installer, so you need to install them separately.\n\n- Node.js installation docs: \u003chttps://nodejs.org/\u003e\n- uv installation docs: \u003chttps://docs.astral.sh/uv/getting-started/installation/\u003e\n\nAfter installation, you can verify them yourself:\n\n```bash\nnode -v\nnpm -v\nnpx -v\nuvx --version\n```\n\n\u003c!-- section: further-documentation --\u003e\n## Further Documentation\n\nThe following repository documents are currently written in Chinese:\n\n- [`docs/data-migration.md`](docs/data-migration.md): data migration between the desktop app and source deployment.\n- [`docs/development.md`](docs/development.md): local build, maintenance commands, version syncing, and release notes.\n- [`docs/environment-variables.md`](docs/environment-variables.md): environment variable reference.\n- [`docs/architecture.md`](docs/architecture.md): current desktop architecture.\n- [`docs/repository-structure.md`](docs/repository-structure.md): repository structure overview.\n\n\u003c!-- section: feedback --\u003e\n## Feedback\n\nIf you need installation help or want to report issues and suggestions, you can reach out through:\n\n- GitHub Issues: \u003chttps://github.com/AstrBotDevs/AstrBot-desktop/issues\u003e\n- QQ Group: 1060046189\n\n\u003c!-- section: license --\u003e\n## License\n\nThis project is licensed under `AGPL-3.0`. See [`LICENSE`](./LICENSE) for the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrbotdevs%2Fastrbot-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrbotdevs%2Fastrbot-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrbotdevs%2Fastrbot-desktop/lists"}