InkOS: 오픈소스 스토리 창작 AI 에이전트 시스템 138

InkOS 는 Narcooo가 GitHub에서 오픈소스로 공개한 이야기 창작 도구로, 주로 소설(장편·단편 모두 가능) 집필에 사용되며, 대본, 인터랙티브 영상 게임, 2차 창작 후속작 및 다국어 번역 작업에도 활용할 수 있습니다. Studio 웹 인터페이스, TUI 터미널, 명령행 세 가지 사용 방식을 제공하며, 제1기 Kimi 오픈소스 협력 파트너에 선정되었습니다. 모든 데이터는 로컬 프로젝트 디렉터리에 저장되며 외부로 원격 측정 데이터를 전송하지 않고, API도 사용자가 직접 구성한 대규모 모델 서비스 제공업체만 호출합니다.

InkOS 핵심 기능

• 장편 소설: InkOS의 주력 기능입니다. 책을 생성하면 시스템이 먼저 세계관, 캐릭터 설정, 권(卷)大纲 및 챕터 의도를 생성한 후, "기획 → 편성 → 집필 → 감사 → 수정 → 상태 동기화" 흐름에 따라 각 챕터를 진행합니다. 전체 과정은 10개의 Agent가 협업하여 수행합니다. 레이더가 시장 트렌드를 스캔하고, 기획자가 챕터 의도를 결정하며, 편성자가 맥락과 규칙을 정리하고, 작가가 본문을 생성하며, 관찰자가 사실을 추출하고, 감사 담당이 37개 차원의 연속성 검사를 수행하고, 수정자가 문제를 해결합니다.

• 단편: 장르나 영감을 입력하면 완성된 본문, 개요, 검토 기록, 소개卖点(매력 포인트) 및 표지 프롬프트를 원클릭으로 생성합니다. 표지 서비스를 설정하면 표지 이미지도 직접 생성할 수 있습니다.

• 인터랙티브 영상 게임: 자연어로 세계 규칙, 시간 진행 방식, 캐릭터 agent, 아이템·증거 규칙을 정의하면 시스템이 세계 상태를 유지 관리합니다. 자유 행동, 클릭 선택, 자동 이미지 생성을 지원하여 인터랙티브 드라마, 멀티 엔딩 스크립트, 텍스트 게임 제작에 적합합니다.

• 스토리 추론: 다음 챕터를 쓰기 전에 현재 정사에 기반하여 2~5개의 격리된 미래 분기를 생성하고, 챕터 비트, 캐릭터 결정, 잠재적 리스크를 가로로 비교합니다. 추론 결과는 후보 계획으로만 저장되며 본문에는 영향을 주지 않습니다.

• 번역: EPUB, 텍스트형 PDF, TXT, Markdown의 챕터 단위 번역을 지원하며, 용어집을 유지 관리하고, 대조 교정 보고서를 생성하며, TXT, Markdown 또는 EPUB로 내보내기를 지원합니다. Studio, Chat, CLI 모두에서 사용 가능합니다.

• AI 느낌 제거: 고빈도 단어, 단조로운 문장 구조, 과도한 요약과 같은 "LLM 느낌" 표현을 자동으로 식별합니다. 작가 agent의 prompt에禁用(금지) 단어 목록과 문체 지문을 내장하여 근본적으로 흔적을 줄입니다. revise --mode anti-detect 명령으로도 기존 챕터를 대상으로专门的인 수정이 가능합니다.

• 문체 모방: inkos style analyze가 참고 텍스트를 분석하여 문장 길이 분포, 단어 빈도 특징, 리듬 패턴을 추출한 뒤 지정된 책에 주입하여 이후 챕터가 해당 스타일을 자동으로 따르도록 합니다.

• 2차 창작: canon(정전延续), au(가공 세계), ooc(성격 재구성), cp(CP 지향) 네 가지 모드를 지원하며, 정전 가져오기 및 2차 창작 감사 차원을 내장하여 설정 모순을 방지합니다.

• 다중 모델 라우팅: 서로 다른 Agent가 서로 다른 모델을 사용할 수 있습니다. 예를 들어 작가는 Claude, 감사는 GPT-4o, 레이더는 로컬 모델을 사용하는 식으로, inkos config set-model 명령으로 agent 단위로 설정할 수 있습니다.

• 데몬 프로세스: inkos up 명령으로 백그라운드 루프를 시작하여 자동으로 챕터를 집필하며, 비중요 문제는 자동으로 진행하고 사람의 판단이 필요한 경우 일시 중지하고 알림을 전송합니다. Telegram, Feishu(飞书), Enterprise WeChat(企业微信) 및 Webhook을 지원합니다.

InkOS 활용 시나리오

• 온라인 문학 작가 연재: 백만 자 장편의 자동 진행, 캐릭터 설정, 복선, 자원 연속성을 시스템이 지속적으로 추적하여 중후반부에도 설정이 무너지지 않습니다.

• 단편 창작자: 표지를 포함한 완전한 단편 패키지를 원클릭으로 생성하며,自媒体, 투고, 연습용으로 적합합니다.

• 대본/인터랙티브 영상 게임 작가: 분기 스토리, 변수 플래그, 멀티 엔딩 스크립트를 노드 이미지와 인터랙션 항목 내보내기와 함께 지원합니다.

• 번역 작업자: EPUB 또는 PDF 전체의 챕터 단위 번역, 용어집 및 교정 보고서 유지 관리.

• 2차 창작 작가: 원작 소스를 기반으로 2차 창작 책을 빠르게 구축하며, 네 가지 모드가 일반적인 창작 수요를 포괄합니다.

• 문체 실험: 좋아하는 작가의 문체를 분석하여 이후 창작물이 해당 스타일에 가깝게 되도록 합니다.

• 오픈 월드/NPC 서사: 텍스트 게임, 인터랙티브 소설, TRPG 보조 도구 제작.

InkOS 장점과 단점

좋은 점

• 오픈소스 무료, 코드 감사 가능, 원격 측정 없음

• 10-Agent 파이프라인이 기획부터 수정까지 전체 체인을 포괄하여 전문성이 높음

• 세 가지 상호작용 방식(Studio/TUI/CLI)으로 시각적 작업과 스크립트 자동화 모두에 적합

• AI 느낌 제거 능력이 뛰어나며,专门的인 反감지(anti-detect) 수정 모드 제공

• 다중 모델 라우팅 지원으로 작업별로 최적 모델 선택 가능

• 데이터가 완전히 로컬에 저장되며 API는 사용자가 구성한 서비스 제공업체로만 전송

• 중국어, 영어, 일본어 다국어 창작 및 번역 지원

• 스토리 추론과 오픈 월드는 다른 도구에는 없는 기능

아쉬운 점

• Node.js 환경과 npm 설치가 필요하여 비기술 사용자에게 친화적이지 않음

• 대규모 모델 API Key를 직접 준비해야 하며 추가 비용 발생

• 학습 곡선이 가파르고, 개념이 많음(기획, 편성, 감사, 리플렉터 등)

• Studio는 로컬 서비스(localhost:4567)이며 클라우드 SaaS가 아님

• AGPL-3.0 라이선스로 상업적 사용에 제한이 있음

• 커뮤니티 규모가 상대적으로 소규모이며, 문제 발생 시 주로 GitHub issue에 의존해야 함

InkOS 사용 튜토리얼

설치

npm i -g @actalk/inkos

모델 설정

방법 1: Studio에서 그래픽으로 설정(초보자 권장).

방법 2: 명령행 전역 설정:

inkos config set-global \
  --provider custom \
  --base-url https://api.moonshot.cn/v1 \
  --api-key sk-... \
  --model kimi-k2.5

프로젝트 초기화

inkos init my-novel
cd my-novel

책 생성 및 집필

inkos book create --title "吞天魔帝" --genre xuanhuan
inkos write next 吞天魔帝          # 다음 챕터 집필(전체 파이프라인)
inkos write next 吞天魔帝 --count 5 # 5개 챕터 연속 집필
inkos status                       # 상태 확인
inkos export 吞天魔帝 --format epub # EPUB 내보내기

자연어 Agent 모드

inkos agent "帮我写一本都市修仙，主角是个程序员"
inkos agent "写下一章，重点写师徒矛盾"

원자 명령(스크립트 및 외부 Agent 호출에 적합)

inkos plan chapter 吞天魔帝 --context "本章重点写师徒矛盾"
inkos compose chapter 吞天魔帝
inkos draft 吞天魔帝
inkos audit 吞天魔帝 31
inkos revise 吞天魔帝 31

Studio 시작

inkos studio
# 기본적으로 localhost:4567 열림

InkOS와 경쟁 제품 비교

왜 InkOS를 선택해야 할까

매번 새 대화를 열 때마다 설정을 다시 붙여 넣어야 하는 것이 아니라, 백만 자급의 창작을 관리할 수 있는 시스템이 필요하다면 InkOS는 시도해 볼 만합니다. 10-Agent 파이프라인이 기획, 집필, 감사, 수정을 폐쇄 루프로 연결하여, 80화째에 집필할 때도 시스템이 5화째에埋아둔 복선을 기억합니다. 오픈소스이기 때문에 프롬프트를 수정하고, Agent를 추가하고, 자신의 모델을 연동할 수 있으며, 데이터도 로컬에 보관됩니다. 기술형 작가, 웹소설 스튜디오 또는 집필 프로세스를 깊이 커스터마이징하고 싶은 사람들에게, 이것은 현재 "AI 소설 집필"을 장난감에서 생산 도구로 바꿀 수 있는 드문 솔루션입니다.

자주 묻는 질문

Q: InkOS는 무료인가요?

예. 프로젝트 자체는 오픈소스이며 무료이고, AGPL-3.0 라이선스를 채택합니다. 단, 대형 모델 API Key는 직접 준비해야 하며, 이 부분은 호출량에 따라 서비스 제공업체에 비용을 지불합니다.

Q: 프로그래밍을 못해도 사용할 수 있나요?

사용할 수 있습니다. Node.js를 설치한 후, npm i -g @actalk/inkos로 설치하고, inkos studio를 실행하면 브라우저에서 그래픽으로 조작할 수 있습니다. 다만 최초 API Key 설정에는 약간의 인내심이 필요합니다.

Q: 어떤 모델을 지원하나요?

Moonshot(Kimi), OpenAI, Anthropic, Google Gemini, OpenRouter, kkaiapi 등을 포함한 모든 OpenAI-compatible 인터페이스를 지원합니다. 서로 다른 Agent에 서로 다른 모델을 설정할 수 있습니다.

Q: 집필한 내용에 AI 티가 나면 어떻게 하나요?

InkOS에는 AI 티 제거 메커니즘이 내장되어 있습니다. 라이터 prompt 레이어에 금칙어 목록과 문체 지문이 있고, 감사관이 LLM의 고빈도 표현을 탐지하며, 수정자는 anti-detect 모드를 실행하여 다시 쓸 수 있습니다. 여전히 만족스럽지 않다면, writing.reviewRetries 값을 낮추어 수정 라운드를 늘리거나, story/author_intent.md의 스타일 지침을 수동으로 조정할 수 있습니다.

Q: 영어 소설을 쓸 수 있나요?

사용할 수 있습니다. --lang en으로 설정하면 되며, 10가지 영어 장르 아카이브(LitRPG, Progression Fantasy, Isekai 등)가 내장되어 있습니다.

Q: 이미 있는 소설을 가져와 이어서 쓸 수 있나요?

사용할 수 있습니다. inkos import chapters로 로컬 텍스트에서 가져오면, 구조화된 상태, 챕터 요약, 복선, 캐릭터 관계를 자동으로 재구축하며, "제X장"과 사용자 정의 분할 모드를 지원합니다.

Q: Studio는 웹 버전인가요, 로컬 프로그램인가요?

로컬 서비스입니다. inkos studio를 실행하면 localhost:4567에서 시작되며, 데이터는 모두 로컬 프로젝트 디렉터리에 저장되고 클라우드에 업로드되지 않습니다.

Q: AGPL-3.0은 상업적 사용에 어떤 영향을 주나요?

InkOS 코드를 수정하여 외부에 서비스를 제공하거나 배포하는 경우, 수정 사항을 오픈소스로 공개해야 합니다. 개인 사용, 내부 사용은 영향을 받지 않습니다. 자세한 내용은 AGPL-3.0 전문을 참조하시기 바랍니다.

관련 정보:

2026년 소설을 어디에投稿할까? 12개 소설 투고 플랫폼 장단점 비교

AI 소설 추천 도구

AI 소설 창작 생성 도구