{"id":31959503,"url":"https://github.com/huggingface/chat-macos","last_synced_at":"2025-10-14T15:32:54.655Z","repository":{"id":257804737,"uuid":"862090368","full_name":"huggingface/chat-macOS","owner":"huggingface","description":"Making the community's best AI chat models available to everyone.","archived":false,"fork":false,"pushed_at":"2025-02-03T21:02:22.000Z","size":4333,"stargazers_count":1982,"open_issues_count":30,"forks_count":87,"subscribers_count":24,"default_branch":"main","last_synced_at":"2025-09-30T18:02:26.593Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","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/huggingface.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-09-24T02:50:17.000Z","updated_at":"2025-09-20T14:14:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"47d2ec8c-336a-44f0-9607-3db0eef78f32","html_url":"https://github.com/huggingface/chat-macOS","commit_stats":null,"previous_names":["huggingface/chat-macos"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/huggingface/chat-macOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Fchat-macOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Fchat-macOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Fchat-macOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Fchat-macOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huggingface","download_url":"https://codeload.github.com/huggingface/chat-macOS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Fchat-macOS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019322,"owners_count":26086711,"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-10-14T02:00:06.444Z","response_time":60,"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":[],"created_at":"2025-10-14T15:32:02.268Z","updated_at":"2025-10-14T15:32:54.650Z","avatar_url":"https://github.com/huggingface.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\" style=\"margin-bottom: 0;\"\u003e\n  \u003cimg src=\"assets/banner.png\" alt=\"HuggingChat macOS Banner\"\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\" style=\"margin-top: 0;\"\u003eHuggingChat macOS\u003c/h1\u003e\n\n![Static Badge](https://img.shields.io/badge/License-Apache-orange)\n[![swift-version](https://img.shields.io/badge/Swift-6.0-brightgreen.svg)](https://github.com/apple/swift)\n[![platform](https://img.shields.io/badge/Platform-macOS_14.0-blue.svg)](https://github.com/apple/swift)\n\n\n### About\nHuggingChat macOS is a native chat interface designed specifically for macOS users, leveraging the power of open-source language models. It brings the capabilities of advanced AI conversation right to your desktop, offering a seamless and intuitive experience.\n\n### Demo\nhttps://github.com/user-attachments/assets/dacc87b2-2242-4ef5-84d5-9f9aae50c453\n\n\n### Installation\n\n1. Go to the [Releases](https://github.com/huggingface/chat-macOS/releases) section of this repository.\n2. Download the latest `HuggingChat-macOS.zip` file.\n3. Unzip the downloaded file.\n4. Drag the `HuggingChat.app` to your Applications folder.\n\n#### Homebrew\nHuggingChat is also available via Homebrew. Simply run:\n\n```bash\nbrew install --cask huggingchat\n```\n\nThat's it! You can now launch HuggingChat from your Applications folder or using the dedicated keyboard shortcut: `⌘ + Shift + Return`.\n\n#### VSCode Integration\nIn order to use HuggingChat in VSCode, you'll need to install the [HuggingChat Extension](https://github.com/cyrilzakka/huggingchat-helper). After downloading it, add it to VSCode by navigating to the Extensions tab and selecting \"Install from VSIX\". Choose the downloaded file and restart VSCode. HuggingChat can now use context from your code editor to provide more accurate responses.\n\n### Development Setup\n#### Prerequisites\n- Xcode 16.0 or later\n- macOS 14.0 or later\n\n#### Building the Project\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/huggingface/chat-macOS.git\n   cd HuggingChat-macOS\n   ```\n2. Open `HuggingChat-macOS.xcodeproj` in Xcode\n3. Select your development team in the project settings if you plan to run on a physical device\n4. Build and run the project (⌘ + R)\n\n### Making Contributions\n#### 1. Choose or Create an Issue\n- Check existing [issues](https://github.com/huggingface/chat-macOS/issues) for something you'd like to work on\n- Create a new issue if you have a bug fix or feature proposal\n- Comment on the issue to let maintainers know you're working on it\n\n#### 2. Fork and Branch\n1. Fork the repository to your GitHub account\n2. Create a new branch for your work:\n   ```bash\n   git checkout -b feature/your-feature-name\n   # or\n   git checkout -b fix/your-bug-fix\n   ```\n\n#### 3. Code Style Guidelines\n- Follow Apple's [Swift API Design Guidelines](https://swift.org/documentation/api-design-guidelines/)\n- Use SwiftLint rules defined in the project\n- Maintain consistent spacing and formatting\n- Write meaningful commit messages\n- Add comments for complex logic\n\n\n### Feedback\n\nWe value your input! If you have any suggestions, encounter issues, or want to share your experience, please feel free to reach out:\n\n2. **GitHub Issues**: For bug reports or feature requests, please create an issue in this repository. \n    - Provide a clear title and description of your feedback\n   - Include steps to reproduce the issue (for bugs) or detailed explanation (for feature requests)\n   - Include the app version number and macOS version\n   - Submit the issue\n\nYour feedback helps improve HuggingChat macOS for everyone. Thank you for your support!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuggingface%2Fchat-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuggingface%2Fchat-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuggingface%2Fchat-macos/lists"}