Repolode
pguso

pguso/ai-agents-from-scratch

node-llama-cpp로 로컬 LLM을 사용해 함수 호출, 메모리, ReAct를 익히며 AI 에이전트를 처음부터 만들어 보는 튜토리얼입니다.

스타
4,871
포크
721
열린 이슈
12
마지막 커밋
3개월 전

어떤 프로젝트인가요?

AI Agents From Scratch는 에이전트 프레임워크에 의존하지 않고 JavaScript로 AI 에이전트를 만드는 방법을 배우는 저장소입니다. node-llama-cpp를 통해 로컬 GGUF 모델을 실행하므로, 추상화 계층 뒤에 감춰진 내용이 아니라 모든 프롬프트, 도구 호출, 반복 과정을 코드에서 직접 확인할 수 있습니다.

자료는 순서대로 진행되는 15개의 예제로 구성되어 있습니다. 기본적인 모델 로딩과 시스템 프롬프트부터 스트리밍, 배치 처리, 함수 호출을 거쳐 영구 메모리, 추론과 행동을 반복하는 ReAct 루프, 오류 처리, 그리고 Tree of Thought, Graph of Thought, Chain of Thought, 임베딩 기반 도구 라우팅 같은 최신 패턴까지 다룹니다. 각 예제 폴더에는 실행 가능한 스크립트와 CODE.md 및 CONCEPT.md 설명이 포함되어 있습니다.

프로젝트를 실행하려면 Node.js 18 이상과 최소 8GB RAM이 필요하며, 동봉된 다운로드 가이드에 따라 모델을 로컬 models 폴더에 저장해야 합니다. agentsfromscratch.com의 연계 웹사이트에서는 코드와 함께 개념 설명을 제공하며, Python 버전 튜토리얼은 별도로 관리됩니다.

핵심 기능

  • 01클라우드 API 키 없이 node-llama-cpp로 로컬 GGUF 모델 실행
  • 02JSON Schema 도구 정의를 사용하는 함수 호출 설명
  • 03추론, 행동, 관찰 단계로 구성된 ReAct 에이전트 루프 포함
  • 04세션이 바뀌어도 사실과 선호 사항을 유지하는 영구 메모리 시연
  • 05재시도, 타임아웃, 대체 동작을 포함한 오류 처리 제공
  • 06각 예제에 코드, 줄별 설명, 개념 설명 포함

활용 사례

  • LangChain이나 유사한 프레임워크를 도입하기 전에 에이전트 내부 동작을 이해하려는 개발자
  • 작은 로컬 모델로 함수 호출과 도구 사용을 배우는 엔지니어
  • Node.js로 오프라인 또는 개인정보 보호가 중요한 LLM 프로토타입을 만드는 팀
  • 에이전트 아키텍처 실습 과정을 준비하는 강사

빠른 시작

  1. 1

    Node.js 18+를 설치하고 모델을 ./models/에 다운로드합니다(DOWNLOAD.md 참조).

  2. 2

    종속 항목을 설치합니다.

    npm install
  3. 3

    입문 예제를 실행합니다.

    node intro/intro.js
  4. 4

    간단한 에이전트 예제를 실행합니다.

    node simple-agent/simple-agent.js

사용 전 알아둘 점

  • 로컬 GGUF 모델을 다운로드해야 하며, 최소 8GB RAM(16GB 권장)이 필요합니다.
  • 프로덕션 프레임워크가 아니라 예제를 포함한 튜토리얼입니다.

토픽

자주 묻는 질문

ai-agents-from-scratch은(는) 무엇인가요?
node-llama-cpp로 로컬 LLM을 사용해 함수 호출, 메모리, ReAct를 익히며 AI 에이전트를 처음부터 만들어 보는 튜토리얼입니다. AI Agents From Scratch는 에이전트 프레임워크에 의존하지 않고 JavaScript로 AI 에이전트를 만드는 방법을 배우는 저장소입니다. node-llama-cpp를 통해 로컬 GGUF 모델을 실행하므로, 추상화 계층 뒤에 감춰진 내용이 아니라 모든 프롬프트, 도구 호출, 반복 과정을 코드에서 직접 확인할 수 있습니다.
ai-agents-from-scratch은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ai-agents-from-scratch은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ai-agents-from-scratch은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. ai-agents-from-scratch의 마지막 커밋은 2026년 7월 24일입니다.
ai-agents-from-scratch은(는) 어디에 사용할 수 있나요?
LangChain이나 유사한 프레임워크를 도입하기 전에 에이전트 내부 동작을 이해하려는 개발자 작은 로컬 모델로 함수 호출과 도구 사용을 배우는 엔지니어 Node.js로 오프라인 또는 개인정보 보호가 중요한 LLM 프로토타입을 만드는 팀 에이전트 아키텍처 실습 과정을 준비하는 강사
ai-agents-from-scratch는 어떻게 설치하나요?
Node.js 18+를 설치하고 모델을 ./models/에 다운로드합니다(DOWNLOAD.md 참조). 종속 항목을 설치합니다.: npm install 입문 예제를 실행합니다.: node intro/intro.js 간단한 에이전트 예제를 실행합니다.: node simple-agent/simple-agent.js
ai-agents-from-scratch은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pguso/ai-agents-from-scratch

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트