Repolode
andrewyng

andrewyng/aisuite

여러 LLM 제공업체에서 공통 OpenAI 스타일 API를 제공하고, 도구와 MCP를 지원하는 Agents API도 갖춘 경량 Python 라이브러리입니다.

스타
16,353
포크
1,734
열린 이슈
161
마지막 커밋
지난달

어떤 프로젝트인가요?

aisuite는 여러 제공업체의 대규모 언어 모델을 하나의 인터페이스로 호출할 수 있는 Python 라이브러리입니다. 모델은 <provider>:<model-name> 형식으로 지정하므로, OpenAI, Anthropic, Google, Ollama 등 지원되는 제공업체 간에 전환할 때 문자열 하나만 바꾸면 됩니다. 요청과 응답은 동일한 구조를 사용하며, temperature와 max_tokens 같은 핵심 매개변수도 제공업체에 관계없이 같은 방식으로 작동합니다.

채팅 계층에 더해 aisuite는 일반 Python 함수를 도구로 사용할 수 있습니다. 스키마를 생성하고, 함수를 호출한 뒤, max_turns로 제어되는 반복 과정에서 결과를 모델에 전달합니다. 더 긴 작업을 위해 Runner, 미리 구성된 파일·git·shell 툴킷, 도구 승인 정책, 실행을 이어서 진행할 수 있는 상태 저장소, Model Context Protocol (MCP) 서버에 대한 네이티브 지원을 갖춘 Agents API도 제공합니다.

또한 동기 및 비동기 스트리밍 기능과 간단한 어댑터 클래스를 통해 새 제공업체를 추가하는 방법도 문서화되어 있습니다.

핵심 기능

  • 01모델 문자열만 바꾸면 여러 LLM 제공업체에서 사용할 수 있는 통합 채팅 완성 API입니다.
  • 02도구 호출 조각을 포함해 동기 및 비동기 호출의 스트리밍 출력을 지원합니다.
  • 03Python 함수를 도구로 전달할 수 있으며, 스키마를 자동 생성하고 여러 차례 반복 호출합니다.
  • 04Runner, 미리 구성된 files/git/shell 툴킷, 도구 승인 정책을 제공하는 Agents API입니다.
  • 05네이티브 MCP 지원을 통해 모든 MCP 서버의 도구를 모델에 전달할 수 있습니다.
  • 06간단한 명명 규칙을 따르는 확장 가능한 제공업체 어댑터입니다.

활용 사례

  • 애플리케이션 코드를 다시 작성하지 않고 OpenAI, Anthropic 및 다른 제공업체를 비교하거나 장애 발생 시 전환하기.
  • 로컬 함수나 MCP 서버를 호출하는 Python 기반 도구 사용 어시스턴트를 구축하기.
  • 코드 저장소의 파일과 git 이력을 다루는 다단계 에이전트를 프로토타이핑하기.
  • 동일한 프롬프트를 로컬 Ollama 모델과 호스팅 API에 실행하기.

빠른 시작

  1. 1

    PyPI에서 aisuite 기본 패키지를 설치합니다

    pip install aisuite
  2. 2

    사용하려는 provider의 SDK를 설치합니다(예: Anthropic)

    pip install 'aisuite[anthropic]'
  3. 3

    Chat Completions 빠른 시작을 따라 provider의 API 키를 설정합니다

  4. 4

    클라이언트를 만들고 provider:model 형식으로 모델을 호출합니다

사용 전 알아둘 점

  • 호출하려는 모델 provider의 API 키가 필요하므로 처음 사용하기 전에 설정 작업을 해야 합니다.
  • Agents API 및 MCP tools와 같은 일부 기능은 추가 설치가 필요하거나 README에서 별도의 개념으로 설명되어 있습니다.
  • aisuite 기반 데스크톱 앱인 OpenWorker는 자체 저장소로 이전했습니다.

토픽

자주 묻는 질문

aisuite은(는) 무엇인가요?
여러 LLM 제공업체에서 공통 OpenAI 스타일 API를 제공하고, 도구와 MCP를 지원하는 Agents API도 갖춘 경량 Python 라이브러리입니다. aisuite는 여러 제공업체의 대규모 언어 모델을 하나의 인터페이스로 호출할 수 있는 Python 라이브러리입니다. 모델은 <provider>:<model-name> 형식으로 지정하므로, OpenAI, Anthropic, Google, Ollama 등 지원되는 제공업체 간에 전환할 때 문자열 하나만 바꾸면 됩니다. 요청과 응답은 동일한 구조를 사용하며, temperature와 max_tokens 같은 핵심 매개변수도 제공업체에 관계없이 같은 방식으로 작동합니다.
aisuite은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
aisuite은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
aisuite은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. aisuite의 마지막 커밋은 2026년 9월 18일입니다.
aisuite은(는) 어디에 사용할 수 있나요?
애플리케이션 코드를 다시 작성하지 않고 OpenAI, Anthropic 및 다른 제공업체를 비교하거나 장애 발생 시 전환하기. 로컬 함수나 MCP 서버를 호출하는 Python 기반 도구 사용 어시스턴트를 구축하기. 코드 저장소의 파일과 git 이력을 다루는 다단계 에이전트를 프로토타이핑하기. 동일한 프롬프트를 로컬 Ollama 모델과 호스팅 API에 실행하기.
aisuite는 어떻게 설치하나요?
PyPI에서 aisuite 기본 패키지를 설치합니다: pip install aisuite 사용하려는 provider의 SDK를 설치합니다(예: Anthropic): pip install 'aisuite[anthropic]' Chat Completions 빠른 시작을 따라 provider의 API 키를 설정합니다 클라이언트를 만들고 provider:model 형식으로 모델을 호출합니다
aisuite은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/andrewyng/aisuite

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

관련 프로젝트