Website - Docs - Community - Bug reports
## Table of Contents
- [⬇️ Download](#️-download)
- [🔮 Overview](#-overview)
- [✨ Features](#-features)
- [🔰 Tech Stack](#-tech-stack)
- [🤗 Contributing](#-contributing)
- [🎗 License](#-license)
## ⬇️ Download
### Homebrew (macOS)
```bash
brew install --cask amical
```
## 🔮 Overview
Local-first AI Dictation app.
Amical is an open source AI-powered dictation and note-taking app that runs entirely on your machine.
Powered by [Whisper](https://github.com/openai/whisper) for speech-to-text and open source LLMs for intelligent processing, Amical gives you the power of AI dictation with complete privacy.
Context-aware dictation that adapts to what you're doing: drafting an email, chatting on Discord, writing prompts in your IDE, or messaging friends. Amical detects the active app and formats your speech accordingly.
## ✨ Features
> ✔︎ - Done, ◑ - In Progress, ◯ - Planned
🚀 Super-fast dictation with AI-enhanced accuracy ✔︎
🧠 Context-aware speech-to-text based on the active app ✔︎
📒 Smart voice notes → summaries, tasks, structured notes ◑
🔌 MCP integration → voice commands that control your apps ◯
🎙️ Real-time meeting transcription (mic + system audio) ◯
🔧 Extensible via hotkeys, voice macros, custom workflows ✔︎
🔐 Privacy-first: works offline, one click setup of local models in-app ✔︎
🪟 Floating widget for frictionless start/stop with custom hotkeys ✔︎
## 🔰 Tech Stack
- 🎤 [Whisper](https://github.com/openai/whisper)
- 🦙 [Ollama](https://ollama.ai)
- 🧑💻 [Typescript](https://www.typescriptlang.org/)
- 🖥️ [Electron](https://electronjs.org/)
- ☘️ [Next.js](https://nextjs.org/)
- 🎨 [TailwindCSS](https://tailwindcss.com/)
- 🧑🏼🎨 [Shadcn](https://ui.shadcn.com/)
- 🔒 [Better-Auth](https://better-auth.com/)
- 🧘♂️ [Zod](https://zod.dev/)
- 🐞 [Jest](https://jestjs.io/)
- 📚 [Fumadocs](https://github.com/fuma-nama/fumadocs)
- 🌀 [Turborepo](https://turbo.build/)
## 🤗 Contributing
Contributions are welcome! Please read the [Contributing Guide][contributing] to get started.
- **💡 [Contributing Guide][contributing]**: Learn about our contribution process and coding standards.
- **🐛 [Report an Issue][issues]**: Found a bug? Let us know!
- **💬 [Start a Discussion][discussions]**: Have ideas or suggestions? We'd love to hear from you.
## 🎗 License
Released under [MIT][license].
[contributing]: https://github.com/amicalhq/amical/blob/main/CONTRIBUTING.md
[license]: https://github.com/amicalhq/amical/blob/main/LICENSE
[discussions]: https://discuss.amical.ai
[issues]: https://github.com/amicalhq/amical/issues
[pulls]: https://github.com/amicalhq/amical/pulls "submit a pull request"
