AI 에이전트와 워크플로를 시각적으로 구축하고 테스트·배포하며, API와 MCP 서버로 바로 노출할 수 있는 플랫폼입니다.
stalkermustang/llm-bulls-and-cows-benchmark
LiteLLM 호환 제공자를 통해 LLM이 Bulls and Cows 게임을 플레이하게 해 성능을 측정하는 Python 프레임워크입니다.
- 스타
- 235
- 포크
- 2
- 열린 이슈
- 0
- 마지막 커밋
- 2년 전
어떤 프로젝트인가요?
LLM Bulls and Cows Benchmark는 코드 맞히기 게임인 Bulls and Cows에서 대형 언어 모델이 얼마나 잘 추론하는지 측정하는 미니 프레임워크입니다. 이 게임에서는 추측할 때마다 정답 숫자와 자리까지 맞힌 개수(bull), 숫자만 맞힌 개수(cow)를 알려줍니다. LiteLLM을 통해 여러 제공자에 연결하므로 OpenAI, Anthropic, OpenRouter 등의 엔드포인트에서 제공하는 모델을 동일한 게임 규칙과 프롬프트로 비교할 수 있습니다.
프레임워크는 성공률, 형식 오류(필수 GUESS 행 형식을 따르지 않는 응답), 그리고 승리한 게임의 평균 턴 수로 측정하는 효율성을 추적합니다. 실시간 진행률 표시줄을 보며 여러 게임을 동시에 실행할 수 있으며, 실행 결과는 전체 대화 로그, Markdown 표, 실행별 비교를 위한 대화형 HTML 그래프로 저장됩니다. 게임 규칙은 숫자 3자리 또는 4자리, 중복 허용 여부에 따라 설정할 수 있으며, 턴 제한과 기타 설정은 YAML 구성 파일에서 관리합니다.
저장소에는 여러 모델의 자체 벤치마크 결과와 각 실행의 예상 API 비용, 신뢰 구간 계산에 사용한 Wilson 점수 구간이 포함되어 있습니다. 자신의 API 키로 LLM 추론 테스트를 재현하거나 확장하려는 개발자를 위한 프로젝트입니다.
핵심 기능
- 01LiteLLM을 통해 다양한 LLM 제공자를 지원합니다
- 02성공률, 형식 오류, 승리한 게임의 평균 턴 수를 보고합니다
- 03실시간 진행률 표시줄과 함께 여러 게임을 동시에 실행합니다
- 04YAML을 통해 숫자 자릿수와 중복 규칙을 설정할 수 있습니다
- 05Markdown 표와 대화형 HTML 시각화 자료를 내보냅니다
활용 사례
- 간단하고 재현 가능한 퍼즐로 여러 LLM의 추론 능력을 비교합니다
- 모델이 엄격한 출력 형식 지침을 따르는지 테스트합니다
- 자신의 API 키를 사용해 공개된 LLM 벤치마크 결과를 재현하거나 확장합니다
빠른 시작
- 1
종속성을 설치하고 pre-commit 훅을 설정합니다
pip install -r requirements.txt pre-commit install - 2
LLM 제공업체의 API 키를 환경 변수로 설정합니다
- 3
원하는 모델과 게임 설정에 맞게 config 파일을 조정합니다
- 4
벤치마크를 실행하고 결과를 시각화합니다
python run_benchmark.py python scripts/visualize_results.py
사용 전 알아둘 점
- 벤치마크를 실행하려면 LLM 제공업체의 유료 API 크레딧이 필요하며, 전체 실행에는 수십 달러가 들 수 있습니다.
- 대부분의 모델은 게임 50개로만 테스트했기 때문에 게시된 결과의 신뢰 구간이 넓습니다.
토픽
자주 묻는 질문
- llm-bulls-and-cows-benchmark은(는) 무엇인가요?
- LiteLLM 호환 제공자를 통해 LLM이 Bulls and Cows 게임을 플레이하게 해 성능을 측정하는 Python 프레임워크입니다. LLM Bulls and Cows Benchmark는 코드 맞히기 게임인 Bulls and Cows에서 대형 언어 모델이 얼마나 잘 추론하는지 측정하는 미니 프레임워크입니다. 이 게임에서는 추측할 때마다 정답 숫자와 자리까지 맞힌 개수(bull), 숫자만 맞힌 개수(cow)를 알려줍니다. LiteLLM을 통해 여러 제공자에 연결하므로 OpenAI, Anthropic, OpenRouter 등의 엔드포인트에서 제공하는 모델을 동일한 게임 규칙과 프롬프트로 비교할 수 있습니다.
- llm-bulls-and-cows-benchmark은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- llm-bulls-and-cows-benchmark은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- llm-bulls-and-cows-benchmark은(는) 아직 유지보수되고 있나요?
- 6개월 이상 커밋 없음. llm-bulls-and-cows-benchmark의 마지막 커밋은 2025년 1월 31일입니다.
- llm-bulls-and-cows-benchmark은(는) 어디에 사용할 수 있나요?
- 간단하고 재현 가능한 퍼즐로 여러 LLM의 추론 능력을 비교합니다 모델이 엄격한 출력 형식 지침을 따르는지 테스트합니다 자신의 API 키를 사용해 공개된 LLM 벤치마크 결과를 재현하거나 확장합니다
- llm-bulls-and-cows-benchmark는 어떻게 설치하나요?
- 종속성을 설치하고 pre-commit 훅을 설정합니다: pip install -r requirements.txt pre-commit install LLM 제공업체의 API 키를 환경 변수로 설정합니다 원하는 모델과 게임 설정에 맞게 config 파일을 조정합니다 벤치마크를 실행하고 결과를 시각화합니다: python run_benchmark.py python scripts/visualize_results.py
- llm-bulls-and-cows-benchmark은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/stalkermustang/llm-bulls-and-cows-benchmark
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
로컬에 데이터를 저장하며 Windows, macOS, Linux에서 실행되는 ChatGPT, Claude 및 기타 LLM용 데스크톱 클라이언트입니다.
동기·비동기 클라이언트와 타입 지정 요청·응답 모델을 제공하는 OpenAI REST API 공식 Python 라이브러리입니다.
도구, 핸드오프, 가드레일, 세션, 트레이싱을 활용해 멀티 에이전트 워크플로를 구축하는 경량 Python 프레임워크로, OpenAI와 100개 이상의 LLM을 제공자에 구애받지 않고 지원합니다.
Google의 코드 우선 Python 프레임워크로, Gemini에 최적화되어 있지만 특정 모델에 종속되지 않으며 AI 에이전트를 구축·평가·배포할 수 있습니다.
OpenAI 모델용 고속 BPE 토크나이저로, 텍스트를 토큰으로 변환하고 손실 없이 다시 복원합니다.