kentjuno/ainovel-cli

ainovel‑cli – AI 기반 다중 에이전트 소설 작성기 (베트남어 및 다국어 지원)

무엇인가요 – Go로 작성된 명령줄/터미널 사용자 인터페이스(TUI) 애플리케이션으로, 여러 LLM 에이전트(조정자, 설계자, 작가, 편집자, 중재자)를 조율하여 장편 소설을 자동으로 초안 작성합니다. 완전히 베트남어로 로컬라이즈된 인터페이스를 제공하며, 베트남어 또는 중국어로 글쓰기를 지원하고, 로컬 Ollama 모델을 사용해 완전히 오프라인으로 실행하거나 클라우드 제공자(OpenRouter, Gemini, Claude, OpenAI, DeepSeek)에 연결할 수 있습니다.

주요 기능

• 다중 에이전트 워크플로우 – 스토리 기획, 초안 작성, 편집, 중재를 별도의 에이전트가 담당하며, 단계별 체크포인트와 복구 기능을 제공합니다.
• 이중 레벨 롤링 기획 – 스토리가 진행됨에 따라 다음 아크만 확장되므로, 매우 긴 소설에서도 컨텍스트 창을 관리하기 쉽게 합니다.
• 프롬프트 캐싱 및 4단계 컨텍스트 압축 – 토큰 사용량을 줄이면서도 내러티브 상태를 유지합니다.
• 풍부한 슬래시 명령어 UI – /diag, /simulate, /import, /export, /sync 등으로 건강 상태를 점검하고, 목표 작가의 스타일을 시뮬레이션하거나, 기존 텍스트를 가져오거나, 완성된 작품을 TXT 또는 EPUB 형식으로 내보낼 수 있습니다.
• 모델 유연성 – 각 역할마다 다른 제공자를 혼합 사용할 수 있습니다(예: 편집에는 강력한 Claude 모델, 초안 작성에는 로컬 Qwen 모델) 및 실시간으로 모델을 전환할 수 있습니다.
• 오프라인 우선 – Ollama를 사용하면 GPU(≥12GB VRAM)에서 100% 로컬로 실행 가능하며, Qwen 2.5/3.5와 같은 오픈소스 모델을 사용할 수 있습니다.
• 베트남어 전용 인터페이스 – 모든 메뉴, 상태 표시줄, 오류 메시지가 번역되었으며, 스토리 내용은 기본적으로 베트남어 또는 중국어로 생성할 수 있습니다.

일반적인 워크플로우

1. 첫 실행 시 설정 마법사에서 제공자 선택, API 키 입력 또는 Ollama 구성, 언어 설정을 수행합니다.
2. TUI 시작 (docker compose run --rm ainovel 또는 ./ainovel-cli).
3. 빠른 시작을 위해 한 문장의 전제를 제공하거나, 공동 창작 모드로 진입하여 세계관과 캐릭터를 반복적으로 개선합니다.
4. 슬래시 명령어를 사용해 개입하거나, 외부 초안을 가져오거나, 원하는 작가의 스타일을 시뮬레이션하거나, 원고를 내보냅니다.
5. 시스템은 각 도구 단계 후 체크포인트를 저장하므로, 충돌이나 Ctrl‑C로 중단되어도 정확히 멈춘 지점에서 재개됩니다.

설치 방법

• Docker (권장): docker compose build && docker compose run --rm ainovel.
• 소스에서 설치: Go ≥ 1.21 설치, 리포지토리 복제 후 go build -o ainovel-cli ./cmd/ainovel-cli 실행 후 ./ainovel-cli 실행.
• 로컬 LLM: 큰 컨텍스트 창을 가진 Ollama 모델 생성 (예: qwen2.5:14b에 num_ctx 65536 설정).
• 클라우드 LLM: config/config.json에 OpenRouter, Gemini, Claude, OpenAI, DeepSeek의 API 키 제공.

디렉터리 구조 (출력은 workspace/ 또는 사용자 지정 NOVEL_DIR 아래에 저장됨):

novels/<title>/output/novel/
├─ chapters/      # 완성된 마크다운 장
├─ drafts/        # 중간 초안
├─ reviews/       # 편집자 품질 보고서
├─ summaries/     # 아크/권 요약
├─ premise.md
├─ characters.md
├─ world_rules.md
└─ meta/          # 체크포인트, 진행 상황, 로그

기술 스택

• 언어: Go
• 에이전트 핵심: agentcore (도구 호출 및 스트리밍)
• LLM 래퍼: litellm
• TUI 프레임워크: Bubble Tea + Lip Gloss
• 라이선스: MIT

누가 사용할 수 있나요 – 장편 소설을 위한 AI 지원이 필요한 작가, 다중 에이전트 LLM 파이프라인을 실험하는 애호가, 또는 복잡한 에이전트 조율 시스템의 실용적인 예제를 찾는 개발자입니다.