Skillget

EXAONE-Cookbook

agent
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 10 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Building Agent Systems with the EXAONE model.

README.md

EXAONE Cookbook

K-EXAONE / EXAONE 모델을 에이전트로 활용하기 위한 오픈소스 Cookbook입니다.
Jupyter 레시피(Track 00–10), exaone/ 라이브러리, RAG 인프라, 벤치마크(eval/), Proof Gallery(implementations/)를 한 저장소에서 제공합니다.

제품명: EXAONE Cookbook

학습 경로 정본: recipes/README.md · 실무 가이드: PLAYBOOK.md · 문서 인덱스: docs/README.md

빠른 시작

git clone <cookbook-url>
cd <cookbook-root>
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
cp .env.example .env   # EXAONE_API_KEY, EXAONE_BASE_URL, EXAONE_MODEL
python -m ipykernel install --user --name exaone-cookbook --display-name "Python (exaone-cookbook)"
jupyter notebook recipes/track00_bootstrap/

API 키만 있으면 Track 00–01부터 바로 실행할 수 있습니다 (Postgres·Docker 불필요).

Proof Gallery(implementations/)를 쓸 때는 upstream을 직접 clone 해야 합니다.
가이드: implementations/README.md § Upstream clone.

설치 경로 (의존성)

용도 권장 방법 Python
레시피·eval·exaone (기본) pip install -r requirements.txt 그다음 pip install -e . 3.12+ (CI 기준)
Proof Gallery (선택) uv sync --project implementations/<repo> repo별 (README 참고)
개발자 lockfile uv sync (루트 pyproject.toml / uv.lock) 3.12+
  • 공식 OSS 경로는 requirements.txt + venv 입니다 (CI·CONTRIBUTING과 동일).
  • pyproject.toml / uv.lock 은 maintainer용 재현 lockfile — pip 사용자는 무시해도 됩니다.

프로젝트 구조

├── recipes/           # Track 00–10 Jupyter 노트북 (+ 트랙별 mcp_demo 등 동반 코드)
├── exaone/            # LLM·에이전트·RAG·메모리·관측 라이브러리
├── eval/              # naive vs harness 벤치마크 (`python -m eval.run`)
├── infrastructure/    # Postgres(pgvector), 임베딩, setup 스크립트
├── implementations/   # 외부 OSS 하니스 + EXAONE 접착 (고수용, optional)
├── submodules/        # upstream clone 위치 (레포 미포함 — 직접 clone)
├── docs/              # 폴더별 안내
├── .env.example
└── requirements.txt

레시피 (Track 00–10)

Track 디렉터리 요약
00 track00_bootstrap/ env, 첫 API 호출
01 track01_exaone_foundation/ 대화·JSON·툴·thinking
02–07 track02_* … track07_* Agent loop, MCP, RAG, memory, safety
08 track08_evaluation_m1_m10/ M1–M10, eval.run
09–10 track09_*, track10_* Framework bridges, AX capstones

노트북별 목표·산출물: 각 트랙 README.md, recipes/README.md.

벤치마크 (eval/)

python -m eval.run --limit 5 --pass-k-trials 1    # default: BFCL 4종
python -m eval.run --limit 25 --pass-k-trials 2 --sleep 3
# Cookbook matrix (M1–M10): docs/eval.md §4.1 — reference numbers in eval/reference/

자세한 지표·Table A reference 표: docs/eval.md · eval/reference/

Proof Gallery (implementations/, optional)

Track 00–10 이후 외부 에이전트 프레임워크에 EXAONE을 붙이는 데모입니다.

cp implementations/smolagents/.env.example implementations/smolagents/.env
uv sync --project implementations/smolagents
./implementations/uv_run.sh smolagents python scripts/check_env.py

implementations/README.md · docs/implementations.md

인프라 (RAG · Track 04)

cd infrastructure/setup
./step1_downloads.sh && ./step2_docker.sh && ./step3_build_rag.sh

infrastructure/setup/README.md

개발

pytest test/unit_exaone test/unit_eval test/unit_infrastructure test/unit_implementations \
  --ignore=test/unit_eval/datasets_smoke \
  -m "not integration and not eval_datasets" -q

CONTRIBUTING.md · SECURITY.md · NOTICE.md · LICENSE.md

트러블슈팅

증상 조치
EXAONE_API_KEY / 401 .env 키·URL·모델 확인
SSL (회사망) REQUESTS_CA_BUNDLE → PLAYBOOK.md Part 8
MCP spawn 실패 pip install -r requirements.txt, python recipes/track03_tools_and_mcp/mcp_demo/server.py
RAG connection refused infrastructure/setup step2~4

라이선스

EXAONE 모델 가중치·API는 LG AI Research 별도 약관을 따릅니다.

Yorumlar (0)

Sonuc bulunamadi