첫 접촉설치일관성 래칫페더레이션비교연구협약GitHub
이 페이지는 기계 번역되었습니다. 내용이 어색하게 느껴지면 이슈를 열어 주세요. 저장소는 이유가 있어 공개되어 있습니다. 번역 문제 신고

CIRIS 설치

ChatGPT와 Gemini를 대체하는 오픈소스 프로그램입니다. 추론 과정을 검증할 수 있고, 29개 언어를 지원하며, Home Assistant와 연동해 완전한 오픈소스 홈 컨트롤을 구현할 수 있습니다.

iPhone, Android, 그리고 Windows, macOS, Linux용 pip / docker / git 설치를 통해 이용할 수 있습니다.

📱 모바일 앱 출시

모바일에서 나만의 AI 에이전트: 개인 정보 보호, 로컬 우선, 오픈소스

추천

1. pip install (권장)

가장 빠르고 간편한 방법입니다. 최초 실행 설정 마법사가 포함되어 있습니다. Windows, macOS, Linux에서 모두 작동합니다.

pip install ciris-agent

실행: ciris-agent를 실행하면 최초 실행 마법사가 시작됩니다

요구 사항: Python 3.10+

다른 설치 방법

2. Docker Compose

격리된 컨테이너 환경에서 CIRIS를 실행합니다. 로컬 또는 서버 배포를 재현 가능하게 유지하고 싶을 때 가장 적합합니다.

docker compose up -d
요구 사항: Docker Engine 20.10+, docker compose 플러그인, compose 파일이 포함된 프로젝트 체크아웃

3. GitHub Clone (개발용)

개발, 커스터마이징, 또는 기여를 위해 저장소를 클론합니다. 전체 소스 코드에 접근할 수 있습니다.

git clone https://github.com/CIRISAI/CIRISAgent.git

다음: 수동 설치 안내는 README.md를 참고하세요

4. CIRISManager (기업/Canary)

점진적 롤아웃, 자동화된 테스트, 롤백 기능이 있는 관리형 canary 배포입니다. 프로덕션 플릿에 적합합니다.

CIRISManager는 상태 모니터링이 포함된 자동화된 블루-그린 배포를 제공합니다. 배포 구성에 대해서는 팀에 문의하세요.

적합한 용도: 기업 배포, 프로덕션 플릿, 관리형 인프라

안녕하세요, CIRIS

첫 번째 응답을 받는 가장 빠른 방법입니다. 에이전트를 시작한 다음 Python에서 호출하세요. 아래 두 블록은 모두 복사해서 바로 사용할 수 있습니다.

1. 에이전트 시작

API 어댑터를 실행합니다. 기본 포트는 8080입니다. 로컬 개발 시 OBSERVER 접근에는 인증이 필요하지 않습니다.

pip install ciris-agent
ciris-agent --adapter api --port 8080

2. Python에서 호출하기

비동기 SDK입니다. response.processing_time_msresponse.state로 모든 호출의 추론 과정을 확인할 수 있습니다.

pip install ciris-sdk

# hello_ciris.py
import asyncio
from ciris_sdk import CIRISClient

async def main():
    async with CIRISClient(
        base_url="http://localhost:8080",
    ) as client:
        response = await client.interact(
            "Hello, CIRIS!"
        )
        print(response.response)
        print(
            f"[{response.state}] "
            f"{response.processing_time_ms}ms"
        )

asyncio.run(main())

SDK는 프리베타 상태입니다. 릴리스 간에 인터페이스가 변경될 수 있습니다. 전체 API (15개 모듈 181개 엔드포인트)는 GitHub의 ciris_sdk에 문서화되어 있습니다.

문제 해결

pip install 실패

Python 3.10 이상이 설치되어 있는지 확인하세요:

python --version

pip 업그레이드를 시도해 보세요:

pip install --upgrade pip
Docker 컨테이너가 시작되지 않음

컨테이너 로그를 확인하세요:

docker logs ciris-agent

Docker Compose 파일을 확인하세요:

docker compose -f ~/ciris/docker-compose.yml ps
도움이 필요하신가요?