{"id":15160115,"url":"https://github.com/renset/macai","last_synced_at":"2025-12-26T16:22:27.458Z","repository":{"id":155561588,"uuid":"617165755","full_name":"Renset/macai","owner":"Renset","description":"Swift powered native macOS client for Ollama, ChatGPT and compatible API-backends","archived":false,"fork":false,"pushed_at":"2024-10-07T23:15:42.000Z","size":13264,"stargazers_count":144,"open_issues_count":6,"forks_count":15,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-29T23:54:52.202Z","etag":null,"topics":["ai","api-client","bot","chat","chatgpt","chatgpt-api","llm","macos","ollama","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://renset.gumroad.com/l/macai","language":"Swift","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/Renset.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":"2023-03-21T20:32:29.000Z","updated_at":"2024-10-27T07:49:41.000Z","dependencies_parsed_at":"2024-04-21T23:38:18.156Z","dependency_job_id":"55947437-c10c-4580-9557-cbb83380455b","html_url":"https://github.com/Renset/macai","commit_stats":{"total_commits":108,"total_committers":1,"mean_commits":108.0,"dds":0.0,"last_synced_commit":"a3398bf9a0f33cc87fc6a509fa314976b3f4f6c7"},"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Renset%2Fmacai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Renset%2Fmacai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Renset%2Fmacai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Renset%2Fmacai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Renset","download_url":"https://codeload.github.com/Renset/macai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325693,"owners_count":20920714,"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":["ai","api-client","bot","chat","chatgpt","chatgpt-api","llm","macos","ollama","swift","swiftui"],"created_at":"2024-09-26T22:21:38.438Z","updated_at":"2025-12-26T16:22:27.451Z","avatar_url":"https://github.com/Renset.png","language":"Swift","readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"256\" src=\"https://github.com/user-attachments/assets/3b5b5587-a83f-4133-b00d-9a8c509661df\" /\u003e\n\u003c/div\u003e\n\u003ch2 align=\"center\"\u003emacai\u003c/h2\u003e\n\n\u003ca href=\"#\"\u003e\u003cimg alt=\"GitHub top language\" src=\"https://img.shields.io/github/languages/top/Renset/macai\"\u003e\u003c/a\u003e \u003ca href=\"#\"\u003e\u003cimg alt=\"GitHub code size in bytes\" src=\"https://img.shields.io/github/languages/code-size/Renset/macai\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/Renset/macai/actions/workflows/swift-xcode.yml\"\u003e\u003cimg alt=\"GitHub Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/Renset/macai/swift-xcode.yml\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/Renset/macai/blob/main/LICENSE.md\"\u003e\u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/Renset/macai\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Renset/macai/releases/latest\"\u003e\u003cimg alt=\"GitHub all releases\" src=\"https://img.shields.io/github/downloads/Renset/macai/total\"\u003e\u003c/a\u003e\n\nmacai (macOS AI) is a simple yet powerful native macOS AI chat client that supports most AI providers: ChatGPT, Claude, xAI (Grok), Google Gemini, Perplexity, Ollama, OpenRouter, and almost any OpenAI-compatible APIs.\n\n\u003cimg width=\"1152\" height=\"821\" src=\"https://github.com/user-attachments/assets/734afb2c-9b77-4076-9f5d-d3d4c94f3f23\" /\u003e\n\n\n## Downloads\n\n### Manual\nDownload [latest universal binary](https://github.com/Renset/macai/releases), notarized by Apple.\n\n### Homebrew\nInstall macai cask with homebrew:\n`brew install --cask macai`\n\n### Build from source\nCheckout main branch and open project in Xcode 14.3 or later\n\n### iCloud Sync (Forks / Custom Builds)\nIf you want iCloud Sync to work in a fork or custom build, you must use your own CloudKit container.\n\n1. Create a CloudKit container in your Apple Developer account.\n2. Enable the iCloud capability for the macai target in Xcode, and add your container.\n3. Update the `CloudKitContainerIdentifier` value in `macai/Info.plist` to your container ID.\n4. Ensure your app’s bundle identifier matches the one you registered for the container.\n\nIf `CloudKitContainerIdentifier` is missing, the app falls back to the default container.\n\n## Contributions\nContributions are welcome. Take a look at [Issues page](https://github.com/Renset/macai/issues) to see already added features/bugs before creating new one. \nYou can also support project by funding. This support is very important for me and allows to focus more on macai development.\n\n\u003ca href=\"https://www.buymeacoffee.com/renset1\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\n\n## Why macai\n- **macOS-native and lightweight**\n- **User-friendly**: simple setup, minimalist light/dark UI\n- **Feature-rich**: vision, image generation, search, reasoning, import/export and more\n- **iCloud Sync**: keep chats, messages, and settings in sync across devices\n- **Private and secure**: no telemetry or usage tracking by macai (Note: Apple may collect anonymized telemetry when iCloud Sync is enabled)\n\n\n## Run with ChatGPT, Claude, xAI or Google Gemini\nTo run macai with ChatGPT or Claude, you need to have an API token. API token is like password. You need to obtain the API token first to use any commercial LLM API. Most API services offer free credits on registering new account, so you can try most of them for free.\nHere is how to get API token for all supported services:\n- OpenAI: https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key\n- Claude: https://docs.anthropic.com/en/api/getting-started\n- Google Gemini: https://ai.google.dev/gemini-api/docs/api-key\n- xAI Grok: https://docs.x.ai/docs#models\n- OpenRouter: https://openrouter.ai/docs/api-reference/authentication#using-an-api-key\n\nIf you are new to LLM and don't want to pay for the tokens, take a look Ollama. It supports dozens of OpenSource LLM models that can run locally on Apple M1/M2/M3/M4 Macs.\n\n## Run with [Ollama](https://ollama.com)\nOllama is the open-source back-end for various LLM models. \nRun macai with Ollama is easy:\n1. Install Ollama from the [official website](https://ollama.com)\n2. Follow installation guides\n3. After installation, select model (llama3.1 or llama3.2 are recommended) and pull model using command in terminal: `ollama pull \u003cmodel\u003e`\n4. In macai settings, open API Service tab, add new API service (Expert mode) and select type Ollama\":\n   \u003cimg width=\"607\" height=\"757\" src=\"https://github.com/user-attachments/assets/19bc239b-f64d-4c8d-85a3-b05e5e727d2c\" /\u003e\n\n5. Select model, and default AI Assistant and save\n6. Test and enjoy!\n\n## System requirements\nmacOS 14.0 and later (both Intel and Apple chips are supported)\n\n## Project status\nProject is in the active development phase.\n\n\n\n## License\n[Apache-2.0](https://github.com/Renset/macai/blob/main/LICENSE.md)\n","funding_links":["https://www.buymeacoffee.com/renset1"],"categories":["Chatbots"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenset%2Fmacai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frenset%2Fmacai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenset%2Fmacai/lists"}