{"id":13911017,"url":"https://github.com/Renset/macai","last_synced_at":"2025-07-18T10:32:10.548Z","repository":{"id":155561588,"uuid":"617165755","full_name":"Renset/macai","owner":"Renset","description":"All-in-one native macOS AI chat application: Deepseek, ChatGPT, Claude, xAI Grok, Google Gemini, Perplexity, OpenRouter, and all Open AI-compatible API services","archived":false,"fork":false,"pushed_at":"2025-07-12T08:21:54.000Z","size":18657,"stargazers_count":616,"open_issues_count":31,"forks_count":52,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-07-13T17:55:19.030Z","etag":null,"topics":["ai","api-client","bot","chat","chatgpt","chatgpt-api","claude","deepseek","gemini","google","grok","llm","macos","ollama","swift","swiftui","swiftui-app","xai","xai-api"],"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":"apache-2.0","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":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":["Renset"],"buy_me_a_coffee":"renset1"}},"created_at":"2023-03-21T20:32:29.000Z","updated_at":"2025-07-13T01:04:36.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":41,"template":false,"template_full_name":null,"purl":"pkg:github/Renset/macai","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","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Renset%2Fmacai/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265742361,"owners_count":23820832,"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","claude","deepseek","gemini","google","grok","llm","macos","ollama","swift","swiftui","swiftui-app","xai","xai-api"],"created_at":"2024-08-07T00:01:54.534Z","updated_at":"2025-07-18T10:32:10.538Z","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=\"1322\" alt=\"macai window\" src=\"https://github.com/user-attachments/assets/3a9677e4-0d75-4d19-9d5f-3d74b896fcf8\"\u003e\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## 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. If you plan to fix bug or implement a feature, select any of the open _unassigned_ issues, and feel free to start working on it.\n\nYou can also support project by funding. This support is very important for me and allows to focus 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## Features\n\n### Core Capabilities\n- Native macOS application built with SwiftUI for optimal performance and system integration\n- Lightning fast search across all chats, messages, and personas\n- Multi-LLM support including:\n  - OpenAI ChatGPT models (gpt-4o, o1-mini, o1-preview and other)\n  - Anthropic Claude\n  - Google Gemini\n  - xAI Grok\n  - Perplexity\n  - OpenRouter\n  - Local LLMs via [Ollama](https://ollama.com)\n  - Any other OpenAI-compatible API\n\n### Advanced Chat Features\n- Image uploads support for certain APIs and models\n- AI Personas with customizable:\n  - System instructions\n  - Temperature settings\n- Intelligent message handling:\n  - Streamed responses for real-time interaction\n  - Adjustable chat context size\n  - Automatic chat naming\n- Rich content support:\n  - Syntax-highlighted code blocks\n  - Interactive HTML/CSS/JavaScript preview\n  - Formatted tables with CSV/JSON export\n  - LaTeX equation rendering\n\n### Privacy \u0026 Data Control\n- 100% local data storage\n- No telemetry or usage tracking\n- Built-in backup/restore functionality with JSON export\n- Complete control over API configurations and keys\n\n### User Experience\n- System-native light/dark theme \n- Per-chat customizable system instructions\n- Clean, native macOS interface\n- Minimal resource usage compared to Electron-based alternatives\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 (free models available 🔥)\n- xAI Grok: https://docs.x.ai/docs#models\n- OpenRouter: https://openrouter.ai/docs/api-reference/authentication#using-an-api-key (\u003e 50 free models 🔥)\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-peasy:\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 and select type \"ollama\":\n   \u003cimg width=\"628\" src=\"https://github.com/user-attachments/assets/2dfb826b-3c1e-4c44-b5e6-e85f35fe76d7\" /\u003e\n5. Select model, and default AI Persona and save\n6. Test and enjoy!\n\n## System requirements\nmacOS 13.0 and later (both Intel and Apple chips are supported)\n\n## Project status\nProject is in the active development phase.\n\n## Screenshots\n\n### Starting screen\n\u003cimg width=\"938\" alt=\"Welcome screen of macai ChatGPT client: light themed window with an icon of happy looking retro-futuristic robot in front of sparkles\" src=\"https://github.com/user-attachments/assets/ad64eba4-adfa-4353-9f05-f9d9124375f4\" /\u003e\n\n### Settings: API Services list\n\u003cimg width=\"562\" alt=\"Settings window with API Services list\" src=\"https://github.com/user-attachments/assets/61ec4db2-56e9-4b78-b6b7-f00fe2e24909\" /\u003e\n\n### Settings: AI Persona editor\n\u003cimg width=\"560\" alt=\"Settings window with AI Persona editor\" src=\"https://github.com/user-attachments/assets/9168a06a-9614-47b7-8353-365ef8b76c2b\" /\u003e\n\n### Chat customization\nAPI Service, AI Persona and system message are customizable in any chat anytime\n\u003cimg width=\"1063\" alt=\"Chat window with system message editing\" src=\"https://github.com/user-attachments/assets/c808340a-aad2-4dd2-912f-0bb6d47918ba\" /\u003e\n\n### Search\n\nhttps://github.com/user-attachments/assets/84d2d813-59bc-4a1a-96af-fc72641d1658\n\n\n\n\n\n## License\n[Apache-2.0](https://github.com/Renset/macai/blob/main/LICENSE.md)\n","funding_links":["https://github.com/sponsors/Renset","https://buymeacoffee.com/renset1","https://www.buymeacoffee.com/renset1"],"categories":["Swift"],"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"}