amicalhq/amical

어떤 프로젝트인가요?

핵심 기능

• 01Whisper 기반 음성-텍스트 변환 받아쓰기와 선택적 AI 기반 정확도 향상.
• 02현재 사용 중인 애플리케이션에 맞춘 문맥 인식형 서식 지정.
• 03앱에서 한 번의 클릭으로 설정할 수 있는 로컬 모델을 사용해 오프라인으로 작동.
• 04받아쓰기를 시작하고 멈출 수 있는 전역 단축키와 플로팅 위젯.
• 05macOS와 Windows에서 사용할 수 있으며, macOS에서는 Homebrew로 설치 가능.

활용 사례

• 타이핑이 느리거나 불편할 때 음성으로 이메일이나 메시지 초안 작성.
• 손을 쓰지 않고 IDE에서 프롬프트나 코드 주석 작성.
• 오디오와 텍스트를 로컬 컴퓨터에만 보관해야 하는 민감한 환경에서 텍스트 받아쓰기.

빠른 시작

1. 1

   Homebrew로 앱 설치하기(macOS)

   brew install --cask amical
2. 2

   서브모듈을 포함해 저장소 클론하기

   git clone --recurse-submodules https://github.com/amicalhq/amical.git
3. 3

   종속성을 설치하고 Node.js 바이너리 다운로드하기

   pnpm install --frozen-lockfile
4. 4

   개발 모드로 데스크톱 앱 시작하기

   pnpm turbo run dev --filter=@amical/desktop

사용 전 알아둘 점

• !데스크톱 앱은 macOS와 Windows에서만 실행됩니다. Linux는 지원하지 않습니다.
• !Whisper 로컬 받아쓰기를 사용하려면 macOS 15 이상이 필요합니다.
• !소스에서 빌드하려면 Xcode 또는 Visual Studio Build Tools와 CMake가 필요하며, 네이티브 코드 컴파일에 몇 분이 소요됩니다.

토픽

자주 묻는 질문

amical은(는) 무엇인가요?

Whisper로 오프라인에서도 작동하는 macOS 및 Windows용 오픈소스 로컬 우선 AI 받아쓰기 앱 Amical은 음성을 텍스트로 변환하며 사용자의 컴퓨터에서만 실행되는 데스크톱 받아쓰기 앱입니다. 음성 인식에는 Whisper를, 후처리에는 오픈소스 LLM을 사용하며, 앱에서 로컬 모델을 다운로드하면 오프라인으로도 작동합니다.

amical은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

amical은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

amical은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. amical의 마지막 커밋은 2026년 10월 13일입니다.

amical은(는) 어디에 사용할 수 있나요?

타이핑이 느리거나 불편할 때 음성으로 이메일이나 메시지 초안 작성. 손을 쓰지 않고 IDE에서 프롬프트나 코드 주석 작성. 오디오와 텍스트를 로컬 컴퓨터에만 보관해야 하는 민감한 환경에서 텍스트 받아쓰기.

amical는 어떻게 설치하나요?

Homebrew로 앱 설치하기(macOS): brew install --cask amical 서브모듈을 포함해 저장소 클론하기: git clone --recurse-submodules https://github.com/amicalhq/amical.git 종속성을 설치하고 Node.js 바이너리 다운로드하기: pnpm install --frozen-lockfile 개발 모드로 데스크톱 앱 시작하기: pnpm turbo run dev --filter=@amical/desktop

amical은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/amicalhq/amical