fluffypony/dothething

Dothething (dtt) – 자율 작업을 위한 로컬 AI 에이전트

정의 – Dothething(dtt로 호출)은 자체 포함된 로컬 실행 AI 어시스턴트입니다. 자연어 지시를 주면 에이전트가 계획을 세우고 도구를 실행하며 각 단계를 감독할 필요 없이 결과를 반환합니다. 이는 OpenRouter를 통해 라우팅되는 LLM 호출과 웹 검색, 개인정보 보호 중심 브라우저, 파일 시스템 액세스, 셸 명령, 이메일, 클립보드 처리를 포함하는 도구 상자를 중심으로 구축되었습니다.

작동 방식 – 각 턴에서 메인 모델은 호출할 도구를 결정하고, 도구 출력을 받은 후 다음 작업을 결정합니다. 루프는 작업이 완료로 표시되거나, 비용/루프 제한에 도달하거나, 에이전트가 진행할 수 없다고 보고할 때까지 계속됩니다. 도구 호출은 일괄 처리할 수 있으며 exec_order 필드로 순서를 지정할 수 있어 가능한 경우 에이전트가 여러 작업을 병렬로 실행할 수 있습니다.

주요 기능

• 연구 및 데이터 추출 – 로컬 SearXNG 인스턴스를 검색하고, 학술 API(OpenAlex, Crossref, PubMed, arXiv)를 쿼리하며, Notte 프레임워크를 통해 강화된 Firefox 포크(Camoufox)로 페이지를 스크래핑합니다.
• 브라우저 자동화 – 캡차, 다단계 로그인, 양식 작성, 클릭, 파일 업로드를 처리하며 필요 시 수동 로그인을 위해 일시 중지할 수 있습니다.
• 파일 및 셸 작업 – 파일 읽기/쓰기, 임의 명령 실행, HTTP 요청, 시스템 클립보드(이미지 포함) 조작.
• 이메일 통합 – AgentMail을 통해 송수신.
• 확장 가능한 스킬 – SKILL.md를 ~/.dtt/skills/에 넣으면 에이전트가 필요 시 스킬을 로드합니다.
• 비용 인식 – OpenRouter를 통해 토큰 사용량과 달러 비용을 추적하고 Anthropic 프롬프트 캐싱으로 비용을 절감합니다.
• 모드 –
  • Normal – 저렴하고 빠른 모델(DeepSeek Flash, Gemini Flash, Claude Sonnet, GPT-5.6 Terra)로 전체 도구 세트를 갖춥니다.
  • Advanced – 어려운 문제를 위한 가장 강력한 모델(Claude Fable + Astra).
  • Quick – 빠른 프론티어 모델(Claude Opus Fast)에서 단발 실행하며 빠른 답변을 위해 도구 세트를 축소합니다.
• 오케스트레이터 및 MCP – 하나의 터미널에서 여러 에이전트를 실행하거나 MCP 서버를 통해 검색/브라우저 도구를 다른 에이전트에 노출합니다.

설치 / 빠른 시작

curl -fsSL dotheth.ing/dtt.sh | bash -s -- --install   # ~/.local/bin/dtt에 설치
# 또는 리포지토리를 클론하고 ./dtt.sh --install 실행

dtt --prompt "지난 20년 동안 파산한 매출 상위 10대 상장 기업을 찾아 원인과 타임라인이 포함된 마크다운 보고서를 작성하세요."

첫 실행 시 Python 3.11+ 가상 환경을 만들고 SearXNG를 설치하며 Notte 브라우저 프레임워크를 설정합니다. 그런 다음 OpenRouter API 키(필수)와 선택적으로 2Captcha 키를 입력하라는 메시지가 표시됩니다.

일반적인 명령줄 플래그

플래그	의미
q / --quick	빠른 단발 모드(계획 없음, 오라클 없음)
--advanced	가장 강력한 모델 사용, 더 높은 추론 깊이
--prompt "..."	작업을 인라인으로 제공(그렇지 않으면 편집기가 열림)
--cwd DIR	파일 작업의 작업 디렉터리
--max-loops N	에이전트 턴의 상한(기본 200, 빠른 모드 15)
--model ROLE=SLUG	역할에 대한 모델 재정의(main, worker, oracle, browser)
--resume ID	이전에 저장된 스레드 계속
--browser-session NAME	명명된 Firefox 프로필 재사용(로그인 유지)
--headed / --headless	브라우저 창 표시 또는 숨기기
--orchestrator	하나의 터미널에서 여러 에이전트 관리
--pipe	파이프라인용 최종 출력만 출력(종료 코드는 성공/부분/실패를 나타냄)
--tui	실험적인 전체 화면 터미널 UI
--notify-desktop / --notify-email EMAIL	작업 완료 시 데스크톱 또는 이메일 알림
--max-cost USD	누적 OpenRouter 비용이 이 금액에 도달하면 중지

시스템 요구 사항

• macOS 또는 Linux
• Python 3.11+(가상 환경에 자동 설치)
• OpenRouter API 키(필수)
• 선택 사항: 2Captcha 키(캡차 해결용), AgentMail 키(이메일), 이미지 클립보드 지원용 wl-clipboard 또는 xclip.

중요성 – Dothething은 완전한 자율 워크플로 스택(LLM 계획, 검색, 개인정보 보호 브라우저 자동화, 파일 및 OS 상호 작용)을 단일 명령줄 도구에 번들로 제공합니다. 고급 사용자는 머신을 떠나지 않고도 복잡하고 다단계이며 인터넷 의존도가 높은 작업을 AI에 위임할 수 있으며 모델, 비용, 개인정보를 세밀하게 제어할 수 있습니다.