sakowicz/actual-ai

해결하는 문제

Actual AI는 Actual Budget용 자동 거래 분류 도구입니다. 대규모 언어 모델(LLM)을 사용하여 거래 세부 정보를 분석하고 가장 적절한 카테고리를 제안함으로써, 미분류 거래에 카테고리를 수동으로 할당하는 번거로움을 제거합니다.

작동 방식

이 애플리케이션은 Actual Budget 서버에 연결하여 카테고리가 없는 거래를 식별합니다. 거래 설명, 금액, 메모를 설정된 LLM 제공자(OpenAI, Anthropic, Google, Ollama 등)에 전송합니다. LLM은 기존 카테고리 구조를 기반으로 거래를 분류합니다.

주요 운영 기능:

• 웹 검색 통합: ValueSerp API를 사용하여 낯선 상점에 대해 웹 검색을 수행하여 LLM이 분류에 더 나은 맥락을 제공받을 수 있도록 합니다.
• 카테고리 확장: 거래가 기존 카테고리에 맞지 않을 경우, LLM이 새로운 카테고리를 제안하고 자동으로 생성할 수 있습니다.
• 스케줄링: cron 스케줄이나 시작 시 실행 가능하여 예산을 최신 상태로 유지할 수 있습니다.
• 검토 시스템: 모든 추측된 거래는 메모에 "guessed"로 표시되고, 실패한 시도는 "not guessed"로 표시되어 사용자가 변경 사항을 검토할 수 있습니다.

대상 사용자

수동 거래 분류에 시간을 들이지 않고 재무 추적을 자동화하고 싶은 Actual Budget 사용자.

주요 특징

• 다중 LLM 지원: OpenAI, Anthropic, Google Generative AI, Ollama, OpenRouter, Groq와 호환됩니다.
• 지능적인 분류: 지급처, 금액, 날짜 등의 거래 메타데이터와 사용자 정의 프롬프트를 사용하여 카테고리를 결정합니다.
• 웹 기반 확장 맥락: 온라인에서 상점 정보를 검색하여 드문 기업에 대한 분류 정확도를 향상시킵니다.
• 자동 카테고리 생성: 현재 그룹에 맞지 않는 거래에 대해 지능적으로 새로운 카테고리를 제안하고 생성할 수 있습니다.
• 안전 우선: 실제 예산 데이터를 수정하지 않고 제안된 변경 사항을 로그로 기록할 수 있는 "드라이 런" 모드를 포함합니다.