MCPcopy Index your code
hub / github.com/amicalhq/amical

github.com/amicalhq/amical @v1.9.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.9.3 ↗ · + Follow
2,639 symbols 6,418 edges 507 files 307 documented · 12%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Amical

PRs Welcome license

discord

Website - Docs - Community - Bug reports

Table of Contents

⬇️ Download

Download for macOS Download for Windows Get it on Google Play Apply for iOS Beta

Homebrew (macOS)

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 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.

Amical dictation demo

✨ 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

🤗 Contributing

Contributions are welcome! Reach out to the team in our Discord server to learn more.

🎗 License

Released under MIT.

Extension points exported contracts — how you extend this code

FormattingProvider (Interface)
(no doc) [6 implementers]
apps/desktop/src/pipeline/core/pipeline-types.ts
LibSQLPersistenceOptions (Interface)
(no doc)
packages/y-libsql/src/index.ts
ButtonProps (Interface)
(no doc)
packages/ui/src/button.tsx
WhisperOptions (Interface)
(no doc)
packages/whisper-wrapper/src/index.ts
ChangelogProps (Interface)
(no doc)
apps/www/components/ui/changelog.tsx
TranscriptionProvider (Interface)
(no doc) [3 implementers]
apps/desktop/src/pipeline/core/pipeline-types.ts
WhisperSegment (Interface)
(no doc)
packages/whisper-wrapper/src/index.ts
SubscriptionFormProps (Interface)
(no doc)
apps/www/components/ui/subscription-form.tsx

Core symbols most depended-on inside this repo

cn
called by 255
apps/desktop/src/lib/utils.ts
getService
called by 146
apps/desktop/src/main/managers/service-manager.ts
on
called by 97
apps/desktop/src/services/model-service.ts
addActiveKey
called by 93
apps/desktop/src/main/managers/shortcut-manager.ts
emit
called by 59
apps/desktop/src/services/model-service.ts
getLogger
called by 46
apps/desktop/src/main/managers/service-manager.ts
isDestroyed
called by 40
apps/desktop/tests/helpers/electron-mocks.ts
getState
called by 38
apps/desktop/src/main/managers/recording-manager.ts

Shape

Function 1,211
Method 1,015
Interface 201
Class 200
Enum 12

Languages

TypeScript87%
C#13%
C++1%

Modules by API surface

packages/native-helpers/windows-helper/src/Models/Generated/Models.cs110 symbols
apps/desktop/src/pipeline/providers/transcription/grpc-dictation-client.ts77 symbols
apps/desktop/tests/helpers/electron-mocks.ts76 symbols
apps/desktop/src/pipeline/providers/transcription/amical-cloud-provider.ts72 symbols
apps/desktop/src/main/managers/recording-manager.ts57 symbols
apps/desktop/src/services/settings-service.ts54 symbols
apps/desktop/src/services/model-service.ts54 symbols
apps/desktop/src/services/platform/native-bridge-service.ts41 symbols
apps/desktop/src/main/managers/shortcut-manager.ts40 symbols
apps/desktop/src/services/telemetry-service.ts34 symbols
apps/desktop/src/main/core/window-manager.ts34 symbols
apps/desktop/src/services/onboarding-service.ts31 symbols

For agents

$ claude mcp add amical \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact