추천
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
안녕하세요, CIRIS
첫 번째 응답을 받는 가장 빠른 방법입니다. 에이전트를 시작한 다음 Python에서 호출하세요. 아래 두 블록은 모두 복사해서 바로 사용할 수 있습니다.
1. 에이전트 시작
API 어댑터를 실행합니다. 기본 포트는 8080입니다. 로컬 개발 시 OBSERVER 접근에는 인증이 필요하지 않습니다.
pip install ciris-agent
ciris-agent --adapter api --port 80802. Python에서 호출하기
비동기 SDK입니다. response.processing_time_ms와 response.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 --versionpip 업그레이드를 시도해 보세요:
pip install --upgrade pipDocker 컨테이너가 시작되지 않음
컨테이너 로그를 확인하세요:
docker logs ciris-agentDocker Compose 파일을 확인하세요:
docker compose -f ~/ciris/docker-compose.yml ps