cli-anything-novita은(는) 무엇을 하나요?
Novita AI를 위한 CLI 도구입니다. DeepSeek, GLM 등 다양한 AI 모델을 제공하는 OpenAI 호환 API 서비스입니다.
설치
이 CLI는 cli-anything-novita 패키지의 일부로 설치됩니다:
pip install cli-anything-novita
사전 요구사항:
- Python 3.10+
- novita.ai에서 발급받은 Novita API 키
사용법
기본 명령어
# 도움말 보기
cli-anything-novita --help
# 대화형 REPL 모드 시작
cli-anything-novita
# 모델과 채팅
cli-anything-novita chat --prompt "AI란 무엇인가?" --model deepseek/deepseek-v3.2
# 스트리밍 채팅
cli-anything-novita stream --prompt "코드에 대한 시를 써줘"
# 사용 가능한 모델 목록
cli-anything-novita models
# JSON 출력 (에이전트 소비용)
cli-anything-novita --json chat --prompt "안녕하세요"
REPL 모드
하위 명령어 없이 호출하면 대화형 REPL 세션이 시작됩니다:
cli-anything-novita
# 탭 완성 및 히스토리 기능과 함께 대화형으로 명령어 입력
명령어 그룹
채팅
Novita API를 통해 AI 모델과 채팅합니다.
| 명령어 | 설명 |
|---|---|
chat | Novita API와 채팅 |
stream | 스트리밍 채팅 완성 |
세션
채팅 히스토리를 관리하는 세션 관리.
| 명령어 | 설명 |
|---|---|
status | 세션 상태 표시 |
clear | 세션 히스토리 지우기 |
history | 명령어 히스토리 보기 |
설정
설정 관리.
| 명령어 | 설명 |
|---|---|
set | 설정 값 설정 |
get | 설정 값 가져오기 (또는 전체 보기) |
delete | 설정 값 삭제 |
path | 설정 파일 경로 표시 |
유틸리티
| 명령어 | 설명 |
|---|---|
test | API 연결 테스트 |
models | 사용 가능한 모델 목록 |
예제
API 키 설정
# 설정 파일을 통해 API 키 설정 (권장)
cli-anything-novita config set api_key "sk-xxx"
# 또는 환경 변수 사용
export NOVITA_API_KEY="sk-xxx"
DeepSeek와 채팅
# 간단한 채팅
cli-anything-novita chat --prompt "양자 컴퓨팅 설명해줘" --model deepseek/deepseek-v3.2
# 스트리밍 채팅
cli-anything-novita stream --prompt "팩토리얼을 계산하는 Python 함수 작성해줘"
연결 테스트
# API 키 및 연결 확인
cli-anything-novita test --model deepseek/deepseek-v3.2
# 사용 가능한 모든 모델 목록
cli-anything-novita models
기본 모델
Novita API는 여러 모델 제공업체를 지원합니다:
| 모델 ID | 제공업체 | 설명 |
|---|---|---|
deepseek/deepseek-v3.2 | DeepSeek | DeepSeek V3.2 모델 (기본값) |
zai-org/glm-5 | Zhipu AI | GLM-5 모델 |
minimax/minimax-m2.5 | MiniMax | MiniMax M2.5 모델 |
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽기 쉬운 (기본값): 표, 색상, 형식화된 텍스트
- 기계가 읽기 쉬운 (
--json플래그): 에이전트 소비용 구조화된 JSON
# 사람용 출력
cli-anything-novita chat --prompt "안녕하세요"
# 에이전트용 JSON 출력
cli-anything-novita --json chat --prompt "안녕하세요"
AI 에이전트를 위한 안내
이 CLI를 프로그래밍 방식으로 사용할 때:
- 항상
--json플래그를 사용하여 파싱 가능한 출력을 얻으세요. - 반환 코드를 확인하세요 - 0은 성공, 0이 아니면 오류입니다.
- stderr를 파싱하여 오류 시 메시지를 확인하세요.
- 모든 파일 작업에 절대 경로를 사용하세요.
- 내보내기 작업 후 출력이 존재하는지 확인하세요.
추가 정보
- 전체 문서: 패키지 내 README.md 참조
- 테스트 커버리지: 패키지 내 TEST.md 참조
- 방법론: cli-anything-plugin의 HARNESS.md 참조
버전
1.0.0