Thaddeus

로컬에서 동작하는 JARVIS 스타일의 개인 비서로, Thach Ngo(Thomas Ngo)가 개발했습니다. 목표는 완전히 로컬에서 실행되며 업무 효율성과 생산성을 높이는 것입니다. Python 오케스트레이터가 로컬 Ollama 모델(Qwen2.5 32B, 도구 호출 가능)을 구동하며, 이 모델은 메모리, 캘린더/미리 알림, 날씨, Notion 작업 추적, Claude Code 위임(계획/구현/검토), 웹 검색, IELTS 채점/연습 문제 생성, 달리기(Strava 데이터 + 로컬 레이스 트래커)를 위해 stdio를 통해 커스텀 MCP 서버를 호출합니다.

개인정보 보호 / 네트워크 경계

대부분은 완전히 로컬에서 실행됩니다 — Ollama 추론, SQLite 메모리, macOS 캘린더/미리 알림 접근(AppleScript 사용). 여러 서버는 명시적으로 허용된 예외로, 네트워크에 접속합니다:

• weather — open-meteo.com으로의 일반 HTTPS GET, API 키 없음, 개인 데이터 없음(좌표 또는 도시 이름만).

• notion — Notion API와 통합 토큰으로 통신하여 작업 데이터베이스를 읽고 관리합니다.

• claude — 클라우드의 LLM(Anthropic의 API, claude CLI를 통해)에 접속하는 유일한 서버입니다. 모든 호출은 읽기 전용 작업의 경우 --permission-mode plan으로, implement_from_plan의 경우 acceptEdits + 명시적 git push/commit 금지 목록과 함께 실행되며 — 실시간으로 확인되며, 요청 내용과 관계없이 절대 커밋하거나 푸시하지 않습니다.

• web_search — 자체 호스팅 SearXNG 인스턴스(searxng/ 참조)를 쿼리합니다. 귀하의 API 키나 계정이 제3자에게 전달되지는 않지만, SearXNG 자체는 메타 검색 애그리게이터로서 결과를 수집하기 위해 여전히 업스트림 엔진(Google, Bing 등)을 네트워크를 통해 쿼리합니다. 두 가지 대안을 시도했으나 기각되었습니다: Brave Search API는 무료 티어에도 신용카드 등록이 필요하며, Google Custom Search API는 2025년 기준 신규 가입이 중단되었습니다.

notion과 claude는 정상적으로 저하됩니다 — 해당 .env 비밀이 설정되지 않은 경우 해당 서버는 경고와 함께 건너뛰고 나머지는 모두 정상적으로 시작됩니다. web_search는 비밀이 필요하지 않지만, SearXNG 컨테이너가 실제로 실행 중이어야 합니다.

strava는 완전히 로컬입니다 — Strava의 실시간 API를 호출하는 대신 사용자 자신의 무료 개인 데이터 내보내기(activities.csv)를 읽습니다(현재 Standard 등급 접근에 월 $11.99가 필요하므로, 2026년 6월 정책 변경 확인). 실시간이 아닙니다. 주기적으로 Strava 계정 설정에서 다시 내보내기하여 새로 고치십시오. 레이스 트래커와 find_races(예정된 레이스 후보를 웹 검색으로 찾기, Strava API에는 페이월 이전에도 레이스 데이터가 없었음)는 Strava 내보내기 없이도 작동합니다.

Strava 내보내기 자동화

내보내기 요청 자체는 로그인된 Strava 브라우저 세션이 필요하므로 자동화할 수 없습니다 — 하지만 ZIP을 다운로드한 후의 모든 것은 자동화할 수 있습니다. LaunchAgent(scripts/install_strava_automation.sh)는 매일 scripts/strava_automation.py를 실행하며, 이 스크립트는:

• ~/Downloads에서 Strava 내보내기 ZIP 파일을 감시하고(Strava의 정확한 파일 이름을 추측하는 것이 아니라 내부에 activities.csv가 있는지 확인하여 감지) 자동으로 data/strava_export/에 압축을 풉니다 — 수동 압축 해제/이동 단계 불필요

• 약 14일마다 Reminders.app에 미리 알림을 생성하여 내보내기를 다시 요청하도록 알림 — 해당 단계는 여전히 사용자가 직접 해야 하므로

두 부분 모두 멱등적입니다(data/의 마커 파일로 추적됨). 따라서 매일 실행 시 할 일이 없는 날에는 아무 일도 일어나지 않습니다. 제거: launchctl bootout gui/$(id -u)/com.thachngo.thaddeus.strava-automation 그런 다음 ~/Library/LaunchAgents/에서 plist를 제거하십시오.

Related MCP server: Conectica

설정

1. ollama serve (아직 실행 중이 아니면), 그런 다음 도구 호출 가능한 Qwen2.5 32B 빌드를 가져옵니다(사용 중인 정확한 태그는 .env의 OLLAMA_MODEL 참조)

2. python3 -m venv .venv && source .venv/bin/activate

3. pip install -e ".[dev]"

4. cp .env.example .env 그리고 WEATHER_DEFAULT_LAT/WEATHER_DEFAULT_LON을 입력합니다.

5. python scripts/sanity_check_sdk.py — 설치된 mcp SDK의 실제 API 표면을 다른 것보다 먼저 확인합니다.

6. python scripts/init_db.py

7. cd searxng && docker compose up -d && cd .. — 로컬 검색 백엔드를 시작합니다(한 번만 실행, 재시작 후에도 계속 실행됨)

8. 선택 사항, 레이스 트래커 외의 도구 실행을 위해: Strava 데이터 내보내기 요청(계정 설정 > 내 계정 > 계정 다운로드 또는 삭제 > 아카이브 요청), 이메일로 도착하면 data/strava_export/에 압축 해제, 그런 다음 python scripts/inspect_strava_export.py를 실행하여 실제 열 이름/단위가 strava_server.py가 가정하는 것과 일치하는지 확인합니다.

9. python -m orchestrator.main