https://github.com/maxwindrich770-boop/j1
https://github.com/maxwindrich770-boop/j1
ai-assistant electron macos
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/maxwindrich770-boop/j1
- Owner: maxwindrich770-boop
- Created: 2026-05-23T15:18:29.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-23T16:19:08.000Z (about 1 month ago)
- Last Synced: 2026-05-23T16:22:31.119Z (about 1 month ago)
- Topics: ai-assistant, electron, macos
- Size: 426 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# J1
A local AI assistant for Mac.
## Requirements
- macOS 14 Ventura or later
- Apple Silicon (M1 or later): download `J1-arm64.dmg`
- Intel Mac: download `J1.dmg`
## Installation
### 1. Install Ollama
Download and install [Ollama](https://ollama.com) — J1 uses it as the local AI backend.
### 2. Install J1
Download the DMG from [Releases](https://github.com/maxwindrich770-boop/J1/releases), open it, and drag J1 to your Applications folder.
> **First launch blocked?** Right-click J1 in Applications → Open → Open anyway. This is a one-time step for unsigned apps.
### 2.5 Connect Obsidian (optional)
If you use [Obsidian](https://obsidian.md) for notes, J1 can search your vault and answer questions from it. No extra setup needed — just point J1 to your vault path in the next step.
### 3. Get your API keys
J1 works without any keys (falls back to local Ollama), but cloud keys make it significantly faster and smarter.
| Service | Free tier | Where to get it |
|---------|-----------|-----------------|
| **Groq** (recommended) | ~500 tokens/sec, generous free tier | [console.groq.com](https://console.groq.com) → API Keys → Create Key |
| **Gemini** | Free, no credit card | [aistudio.google.com/api-keys](https://aistudio.google.com/api-keys) → Create API Key |
| **OpenAI** | Pay-as-you-go | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) → Create new secret key |
| **Anthropic** | Pay-as-you-go | [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys) → Create Key |
| **OpenRouter** | Free credits on signup, 300+ models | [openrouter.ai/keys](https://openrouter.ai/keys) → Create Key |
| **Kimi (Moonshot)** | Pay-as-you-go | [platform.moonshot.cn](https://platform.moonshot.cn) → API Keys |
| **Tavily** (web search) | 1,000 searches/month free | [tavily.com](https://tavily.com) → Dashboard → API Keys |
All providers are optional — J1 falls back to the next available one automatically. Groq is the recommended starting point as it offers the fastest free tier.
**iCloud Mail & Calendar (optional)**
J1 can read your unread iCloud emails and upcoming calendar events.
Use an [App-Specific Password](https://appleid.apple.com) — never your Apple ID password.
Go to appleid.apple.com → Security → App-Specific Passwords → click "+" → name it "J1".
### 4. Configure
Open J1 → Settings → Configuration. All options (model, language, voice, API keys, iCloud, Obsidian vault, and more) are editable in the app — no manual file editing required.
## Upcoming
### 1. Google Integration
Support for Google Calendar, Gmail, Google Drive, Google Tasks, and Google Contacts — the same features currently available for iCloud users.
### 2. Windows Support
Native Windows compatibility. Main blocker is the macOS-only `afplay` audio player.
### 3. Configurable Provider Priority
Let users define their own fallback chain order (e.g. OpenAI → Groq → Anthropic → Ollama) directly in Settings.
## Credits
See [CREDITS.md](CREDITS.md).