Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/renset/macai
Swift powered native macOS client for Ollama, ChatGPT and compatible API-backends
https://github.com/renset/macai
ai api-client bot chat chatgpt chatgpt-api llm macos ollama swift swiftui
Last synced: 2 days ago
JSON representation
Swift powered native macOS client for Ollama, ChatGPT and compatible API-backends
- Host: GitHub
- URL: https://github.com/renset/macai
- Owner: Renset
- License: mit
- Created: 2023-03-21T20:32:29.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-07T23:15:42.000Z (3 months ago)
- Last Synced: 2024-10-29T23:54:52.202Z (about 2 months ago)
- Topics: ai, api-client, bot, chat, chatgpt, chatgpt-api, llm, macos, ollama, swift, swiftui
- Language: Swift
- Homepage: https://renset.gumroad.com/l/macai
- Size: 12.6 MB
- Stars: 144
- Watchers: 4
- Forks: 15
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# macai
macai (macOS AI) is a simple yet powerful native macOS client made to interact with modern AI services (ChatGPT, Claude, xAI (Grok), Google Gemini, Ollama and other compatible APIs).
## Downloads
You can download latest binary, notarized by Apple, on [Releases](https://github.com/Renset/macai/releases) page.
You can also support project on [Gumroad](https://renset.gumroad.com/l/macai).
## Build from source
Checkout main branch and open project in Xcode 14.3 or later
## Features
### Core Capabilities
- Native macOS application built with SwiftUI for optimal performance and system integration
- Lightning fast search across all chats, messages, and personas
- Multi-LLM support including:
- OpenAI ChatGPT models (gpt-4o, o1-mini, o1-preview and other)
- Anthropic Claude
- Google Gemini
- xAI Grok
- Local LLMs via [Ollama](https://ollama.com)
- Any OpenAI-compatible API
### Advanced Chat Features
- AI Personas with customizable:
- System instructions
- Temperature settings
- Intelligent message handling:
- Streamed responses for real-time interaction
- Adjustable chat context size
- Automatic chat naming
- Rich content support:
- Syntax-highlighted code blocks
- Interactive HTML/CSS/JavaScript preview
- Formatted tables with CSV/JSON export
- LaTeX equation rendering
### Privacy & Data Control
- 100% local data storage
- No telemetry or usage tracking
- Built-in backup/restore functionality with JSON export
- Complete control over API configurations and keys
### User Experience
- System-native light/dark theme support
- Per-chat customizable system instructions
- Clean, native macOS interface
- Minimal resource usage compared to Electron-based alternatives
## Run with ChatGPT, Claude, xAI or Google Gemini
To 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.
Here is how to get API token for all supported services:
- OpenAI: https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key
- Claude: https://docs.anthropic.com/en/api/getting-started
- Google Gemini: https://ai.google.dev/gemini-api/docs/api-key
- xAI Grok: https://docs.x.ai/docs#models
If you are new to LLM and don't want to pay for the tokens, take a look at Ollama. It supports dozens of OpenSource LLM models that can run locally on Apple M1/M2/M3/M4 Macs.
## Run with [Ollama](https://ollama.com)
Ollama is the open-source back-end for various LLM models.
Run macai with Ollama is easy-peasy:
1. Install Ollama from the [official website](https://ollama.com)
2. Follow installation guides
3. After installation, select model (llama3.1 or llama3.2 are recommended) and pull model using command in terminal: `ollama pull `
4. In macai settings, open API Service tab, add new API service and select type "ollama":
5. Select model, and default AI Persona and save
6. Test and enjoy!
## System requirements
macOS 13.0 and later (both Intel and Apple chips are supported)
## Project status
Project is in the active development phase.
## Contributions
Contributions are welcome. Take a look at [macai project page](https://github.com/users/Renset/projects/1) and [Issues page](https://github.com/Renset/macai/issues) to see planned features/bug fixes, or create a new one.
## Screenshots
### Starting screen
### Settings: API Services list
### Settings: AI Persona editor
### Chat customization
API Service, AI Persona and system message are customizable in any chat anytime
### Search
https://github.com/user-attachments/assets/84d2d813-59bc-4a1a-96af-fc72641d1658
## License
[Apache-2.0](https://github.com/Renset/macai/blob/main/LICENSE.md)