{"id":13582858,"url":"https://github.com/BruceMacD/chatd","last_synced_at":"2025-04-06T17:32:32.158Z","repository":{"id":204368495,"uuid":"707501489","full_name":"BruceMacD/chatd","owner":"BruceMacD","description":"Chat with your documents using local AI","archived":false,"fork":false,"pushed_at":"2024-07-06T01:21:36.000Z","size":2176,"stargazers_count":1020,"open_issues_count":27,"forks_count":72,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-01T21:57:17.430Z","etag":null,"topics":["chat","desktop","electron","llama2","llm","mistral","mistral-7b","ollama","rag"],"latest_commit_sha":null,"homepage":"https://chatd.ai","language":"JavaScript","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/BruceMacD.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}},"created_at":"2023-10-20T03:25:26.000Z","updated_at":"2025-03-30T20:48:41.000Z","dependencies_parsed_at":"2023-12-01T05:24:36.540Z","dependency_job_id":"bc06d4a9-aac7-4b4d-acfb-224f612cfdae","html_url":"https://github.com/BruceMacD/chatd","commit_stats":{"total_commits":97,"total_committers":4,"mean_commits":24.25,"dds":"0.030927835051546393","last_synced_commit":"a2160988a7f08ca682cbe4b07345868f7c1bc2d3"},"previous_names":["brucemacd/chatd"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BruceMacD%2Fchatd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BruceMacD%2Fchatd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BruceMacD%2Fchatd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BruceMacD%2Fchatd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BruceMacD","download_url":"https://codeload.github.com/BruceMacD/chatd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247522739,"owners_count":20952615,"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","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":["chat","desktop","electron","llama2","llm","mistral","mistral-7b","ollama","rag"],"created_at":"2024-08-01T15:03:04.804Z","updated_at":"2025-04-06T17:32:28.364Z","avatar_url":"https://github.com/BruceMacD.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Web \u0026 Desktop UIs","A01_文本生成_文本对话","rag"],"sub_categories":["大语言对话模型及数据"],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"./screenshots/logo.png\" width=\"300\"\u003e\n\u003c/div\u003e\n\n[See a video demo.](https://github.com/BruceMacD/chatd/assets/5853428/a7d8b77c-beae-41a4-bfd6-0fd5cf932b43)\n\nChat with your documents using local AI. All your data stays on your computer and is never sent to the cloud. Chatd is a completely private and secure way to interact with your documents.\n\nChatd is a desktop application that lets you use a local large language model (`Mistral-7B`) to chat with your documents. What makes chatd different from other \"chat with local documents\" apps is that it comes with the local LLM runner packaged in. This means that you don't need to install anything else to use chatd, just run the executable.\n\nChatd uses Ollama to run the LLM. Ollama is an LLM server that provides a cross-platform LLM runner API. If you already have an Ollama instance running locally, chatd will automatically use it. Otherwise, chatd will start an Ollama server for you and manage its lifecycle.\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"./screenshots/chat_screen.png\" width=\"30%\"\u003e\u003c/img\u003e\n    \u003cimg src=\"./screenshots/welcome_screen.png\" width=\"30%\"\u003e\u003c/img\u003e\n    \u003cimg src=\"./screenshots/home_screen.png\" width=\"30%\"\u003e\u003c/img\u003e\n\u003c/div\u003e\n\n## Quickstart\n\n1. Download the latest release from [chatd.ai](https://chatd.ai) or the [releases page](https://github.com/BruceMacD/chatd/releases).\n2. Unzip the downloaded file.\n3. Run the `chatd` executable.\n\n## Advanced Setup\n\n- [Enable GPU support.](docs/enable_gpu_support.md)\n- [Select a custom model.](docs/select_a_custom_model.md)\n\n## Links\n\n- [chatd.ai](https://chatd.ai)\n- [ollama.ai](https://ollama.ai)\n\n## Development\n\nRun the following commands in the root directory.\n\n```bash\nnpm install\nnpm run start\n```\n\n## Packaging and Distribution\n\n### MacOS\n\n1. Download the latest `ollama-darwin` release for MacOS from [here](https://github.com/ollama/ollama/releases).\n2. Make the downloaded binary executable: `chmod +x path/to/ollama-darwin`\n3. Copy the `ollama-darwin` executable to the `chatd/src/service/ollama/runners` directory.\n4. Optional: The Electron app needs be signed to be able to run on MacOS systems other than the one it was compiled on, so you need a developer certificate. To sign the app, set the following environment variables:\n\n```bash\nAPPLE_ID=your_apple_id@example.com\nAPPLE_IDENTITY=\"Developer ID Application: Your Name (ABCDEF1234)\"\nAPPLE_ID_PASSWORD=your_apple_id_app_specific_password\nAPPLE_TEAM_ID=ABCDEF1234\n```\n\nYou can find your Apple ID, Apple Team ID, and Apple ID Application in your Apple Developer account. You can create an app-specific password [here](https://appleid.apple.com/account/manage).\n\n5. Run `npm run package` to package the app.\n\n### Windows\n\n1. Download the latest `ollama-windows-amd64.zip` release from [here](https://github.com/ollama/ollama/releases).\n2. Copy the contents of the zip into `chatd/src/service/ollama/runners/`.\n3. Run `npm run package` to package the app.\n\nNote: The Windows app is not signed, so you will get a warning when you run it.\n\n### Linux\n\n1. Download the latest `ollama-linux-amd64` release from [here](https://github.com/ollama/ollama/releases).\n2. Copy the `ollama` executable to `chatd/src/service/ollama/runners/ollama-linux`.\n3. Run `npm run package` to package the app.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBruceMacD%2Fchatd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBruceMacD%2Fchatd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBruceMacD%2Fchatd/lists"}