도구별 실전 가이드 · 공식 정보 확인 2026-08-20

atomic-agent MIT 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: Desktop, CLI · 페이지 갱신: · 운영·편집 기준

GGUF 로컬 모델을 사용해 긴 대화를 유지하고 브라우저·셸 등 도구 호출을 기기 안에서 수행한다.

GGUF 로컬 모델을 사용해 긴 대화를 유지하고 브라우저·셸 등 도구 호출을 기기 안에서 수행한다. atomic-agent의 첫 실전 과제는 “로컬 폴더의 공개 텍스트 파일 세 개를 읽어 제목 목록만 만든다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “samples 폴더의 .txt 파일 이름과 첫 줄을 표로 정리하고 파일은 수정하지 마” 같은 입력으로 atomic-agent의 핵심 기능을 시험하려는 사람
  • 네트워크 연결 없이 실제 세 파일만 읽고 쓰기 명령이나 브라우저 동작을 실행하지 않는다. 기준으로 atomic-agent 결과를 직접 검수할 수 있는 경우
  • Desktop·CLI 환경에서 MIT 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • 로컬 모델에 최적화된 장문맥 도구 실행 에이전트 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 모델이 로컬이어도 에이전트 도구에는 파일·브라우저·셸 제어권이 남으므로 허용 경로와 명령을 제한하지 않으면 시스템 변경이 가능하다.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

로컬 GGUF와 도구 목록 고정

llama.cpp 모델과 읽기 도구만 활성인 사설 세션이 열린다.

참고 시작점: Atomic Agent에서 작은 GGUF 모델을 고르고 browser·write·shell 도구를 꺼 달라. 결과 기록에 “local-first” 각각의 확인 위치를 빠뜨리지 말아 달라.

  1. 로컬 GGUF 파일과 컨텍스트 크기를 확인한다.
  2. llama.cpp 엔드포인트를 모델 경로로 지정한다.
  3. 파일 목록 읽기 외 도구를 모두 비활성화한다.

긴 폴더 목록을 확장자별 집계

샌드박스의 md·png·json 개수가 원본과 맞는 표로 나온다.

참고 시작점: 테스트 폴더 파일 목록을 컨텍스트로 주고 확장자별 개수만 계산해 달라. 실제 실행 흔적에서 “long context”·“tool calling”·“TUI” 용어가 드러나는 부분을 함께 캡처해 달라.

  1. 샌드박스 경로 밖 접근을 금지한다.
  2. 도구 호출로 파일명 목록만 읽는다.
  3. 세 확장자의 개수를 표 한 개로 답하게 한다.

Playwright·셸 미호출 확인

로컬 추론과 읽기 호출만 남고 파일 변화가 없다.

참고 시작점: Atomic Agent 세션 로그에서 모델 경로와 호출 도구를 확인하고 폴더 해시를 다시 계산해 달라. “local model”와 관련된 입력값 또는 출력값을 근거로 남겨 달라.

  1. 로그에 OpenAI나 외부 엔드포인트가 없는지 본다.
  2. browser automation과 Playwright 호출이 0건인지 센다.
  3. 전후 파일 목록과 해시가 같은지 확인한다.

무료 조건과 주의점

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

모델이 로컬이어도 에이전트 도구에는 파일·브라우저·셸 제어권이 남으므로 허용 경로와 명령을 제한하지 않으면 시스템 변경이 가능하다.

직접 대안과 비교

  • hermes-agent — Hermes Agent도 로컬 모델과 제한된 파일 도구로 샌드박스 목록을 집계할 수 있다.

공식 근거와 확인일

atomic-agent 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보GGUF 로컬 모델을 사용해 긴 대화를 유지하고 브라우저·셸 등 도구 호출을 기기 안에서 수행한다.atomic-agent 공식 사이트
무료 조건MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지GGUF 로컬 모델을 사용해 긴 대화를 유지하고 브라우저·셸 등 도구 호출을 기기 안에서 수행한다.공식 제품 페이지