수록 현황:458 건의 뉴스/102 개의 AI 도구/415 개의 오픈소스 프로젝트/75 개의 학습 자료
홈뉴스오픈소스모델AI 도구Skills학습 자료
홈 / 오픈소스 / inkos

inkos

InkOS는 장편 소설, 단편 소설, 팬 픽션 및 인터랙티브 월드를 위한 오픈소스 AI 에이전트 시스템으로, 웹 스튜디오, 터미널 UI 및 CLI를 통해 사용할 수 있습니다.

TypeScriptAGPL-3.0Agent
⭐ GitHubhttps://github.com/Narcooo/inkos
10,333
스타 수
+0
스타 증가율
2026년 10월 11일
최근 업데이트
0
클릭 수

1. 프로젝트 개요

InkOS는 창작 글쓰기를 위한 오픈소스(AGPL-3.0) AI 에이전트 시스템입니다. 작가가 장편 연재 소설, 단편 소설, 시나리오, 팬 픽션 및 인터랙티브 월드를 계획하고, 초안을 작성하고, 검토하고, 수정할 수 있도록 도와주며, 수백 개의 챕터에 걸쳐 등장인물, 플롯 라인 및 세계관 상태의 일관성을 유지합니다. 모든 것은 웹 스튜디오, 터미널 TUI, CLI라는 세 가지 인터페이스를 통해 하나의 작업 공간에서 관리됩니다.

2. 배경 및 포지셔닝

제작 배경

단일 프롬프트로 장편을 생성하면 내용이 표류하는 경향이 있습니다. 등장인물이 변하고, 복선이 잊히며, 앞선 내용과 모순되는 사실이 나타납니다. InkOS는 글쓰기를 전문화된 에이전트로 분할하고, 스토리 상태를 모델의 컨텍스트 창에만 의존하는 대신 구조화되고 재구축 가능한 메모리에 저장하여 이 문제를 해결합니다.

유사 프로젝트와의 차별점

  • 단일 프롬프트가 아닌 파이프라인: 전담 플래너, 컴포저, 작가, 세틀러, 감사자 및 수정자 에이전트.
  • 영구 메모리: 표준 JSON 상태, 사람이 읽을 수 있는 Markdown 프로젝션 및 재구축 가능한 SQLite FTS5/BM25 검색 인덱스.
  • 원자적 커밋: 챕터, 상태, 훅 및 스냅샷이 함께 커밋되므로 실패한 실행이 절반만 업데이트된 책을 남기지 않습니다.
  • 소설보다 광범위: 단편 소설, 시나리오, 스토리보드, 인터랙티브 플레이, 팬 픽션, 스타일 모방 및 장문 번역이 하나의 작업 공간을 공유합니다.
  • 에이전트 네이티브: 표준 SKILL.md 형식의 19가지 내장 스킬을 제공하며 Claude Code 및 OpenClaw와 같은 다른 에이전트에서 구동할 수 있습니다.

3. 기능 분류

✍️ 장편 글쓰기

  • 약 6개의 협력 에이전트(플래너, 컴포저, 작가, 세틀러, 감사자, 수정자)
  • 예시: inkos write next, --count를 사용한 일괄 작성, inkos write rewrite, inkos review, inkos revise
  • 목적: 일관된 플롯과 등장인물로 연재 챕터를 생성합니다.

🧠 메모리 및 제어

  • 예시: 표준 JSON 상태, Markdown 프로젝션, SQLite FTS5/BM25 인덱스, author_intent.md 및 current_focus.md, 챕터별 컨텍스트 추적
  • 목적: 긴 이야기의 일관성을 유지하고 작가가 방향을 설정할 수 있게 합니다.

📖 단편 소설 및 표지

  • 예시: inkos short run, inkos short revise, 개요, 검토 기록, 판매 카피, 표지 프롬프트 및 선택적 표지 이미지
  • 목적: 지원 자료와 함께 완성된 단편 작품을 생성합니다.

🎮 인터랙티브 플레이

  • 예시: 오픈 월드 모드, 분기형 스토리, 클릭 가능한 선택지, 자유 형식 액션, HUD, 자동 일러스트레이션
  • 목적: 스토리 월드를 플레이 가능한 경험으로 전환합니다.

🎨 스타일, 팬 픽션 및 가져오기

  • 예시: inkos style analyze, inkos fanfic init(캐논, AU, OOC, CP 모드), inkos import chapters, inkos import canon
  • 목적: 스타일을 모방하거나, 기존 작품을 확장하거나, 기존 챕터에서 계속 작업합니다.

🔌 모델, 스킬 및 자동화

  • 19가지 내장 스킬; 에이전트별 다중 모델 라우팅
  • 예시: OpenAI Chat/Responses, Anthropic Messages, Gemini, DeepSeek, OpenRouter, Ollama 및 LM Studio; 데몬 모드(inkos up); Telegram, Feishu, WeCom 및 서명된 웹훅을 통한 알림
  • 목적: InkOS를 자신의 모델 설정 및 워크플로에 맞게 조정합니다.

4. 주요 특징

  • 다중 에이전트 글쓰기 파이프라인: 각 단계는 단일 책임을 가지므로 출력을 더 쉽게 검토하고 수정할 수 있습니다.
  • 재구축 가능한 메모리: 검색 인덱스는 표준 상태에서 재생성할 수 있으며 Markdown 프로젝션은 읽고 편집하기 쉽게 유지됩니다.
  • 증거 기반 감사: 감사자는 증거와 함께 관찰 내용을 기록합니다. 수정은 요청할 때만 이루어집니다.
  • 세 가지 인터페이스, 하나의 작업 공간: 프로젝트를 변경하지 않고 스튜디오, TUI 및 CLI 간에 전환할 수 있습니다.
  • 유연한 모델 지원: 공급자를 혼합하고 로컬 모델을 포함한 다양한 모델에 서로 다른 에이전트를 라우팅할 수 있습니다.
  • 확장 가능한 스킬: 프로젝트, 사용자 및 환경별 스킬 디렉토리가 지원되며 @skill-id는 특정 턴에 스킬을 강제합니다.

5. 역할별 사용 사례

  • 일반 개발자: CLI로 책 생성 및 내보내기를 스크립팅하거나(--json 출력은 많은 명령에서 사용 가능) 스킬을 통해 에이전트 워크플로에 InkOS를 통합합니다.
  • 작가 및 창작자: 일관된 세계관 상태로 연재 소설, 단편 소설 및 팬 픽션을 초안 작성합니다.
  • 게임 및 인터랙티브 미디어 디자이너: 분기형 내러티브 및 오픈 월드 시나리오를 프로토타이핑합니다.
  • DevOps/SRE: 데몬(inkos up / inkos down)을 실행하고 HMAC-SHA256으로 서명된 웹훅을 통해 알림을 받습니다.
  • 연구자: 다중 에이전트 장문 컨텍스트 생성 및 구조화된 메모리 설계를 연구합니다.

6. 시작하기

필요한 것 찾기

inkos --help
inkos doctor

저장소의 docs/ 폴더와 skills/ 디렉토리를 살펴보세요.

설치 및 통합

Node.js 22.16 이상이 필요합니다.

npm i -g @actalk/inkos
inkos init my-novel
cd my-novel
inkos

스튜디오 설정 또는 CLI를 통해 모델을 구성합니다:

inkos config set-global --provider <provider> --base-url <url> --api-key <key> --model <model>

일반적인 CLI 흐름:

inkos book create --title "My Novel" --genre xuanhuan
inkos write next "My Novel" --count 5
inkos export "My Novel" --format epub

OpenClaw에서 스킬로 사용하려면:

clawhub install inkos

기여하기

pnpm install
pnpm dev
pnpm test
pnpm typecheck

CONTRIBUTING.md를 읽은 후 이슈 또는 풀 리퀘스트를 열어주세요.

7. 프로젝트 구조

inkos/
├── packages/        # 워크스페이스 패키지 (core, CLI, Studio)
├── skills/          # 내장 스킬 (SKILL.md 형식)
├── docs/            # 문서
├── spec/            # 사양
├── scripts/         # 유지 관리 스크립트
├── test-project/    # 테스트용 샘플 프로젝트
├── assets/          # 이미지 및 정적 자산
├── README.md        # 중국어 README
├── README.en.md     # 영어 README
├── CONTRIBUTING.md
├── CHANGELOG.md
└── pnpm-workspace.yaml

8. 관련 생태계

  • pi 에이전트 런타임 (@mariozechner/pi-ai, @mariozechner/pi-agent-core): InkOS 2.0이 구축된 하네스.
  • 스튜디오 스택: Vite, React 및 Hono.
  • 저장 및 검증: SQLite FTS5/BM25 및 Zod 스키마.
  • 모델 공급자: OpenAI 호환, Anthropic, Google Gemini, DeepSeek, OpenRouter, Ollama, LM Studio 등.
  • 에이전트 플랫폼: 스킬을 통한 Claude Code 및 OpenClaw/ClawHub.

9. 라이선스

InkOS는 AGPL-3.0으로 배포됩니다.

  • ✅ 상업적 목적을 포함하여 소프트웨어를 사용, 수정 및 배포할 수 있습니다.
  • ✅ 자신의 글쓰기 프로젝트를 위해 비공개로 실행할 수 있습니다.
  • ❌ 동일한 라이선스로 해당 소스를 제공하지 않고 수정 버전을 배포할 수 없습니다.
  • ℹ️ 수정 버전을 네트워크 서비스로 제공하는 경우 AGPL-3.0은 사용자에게 소스를 제공하도록 요구합니다.
  • ℹ️ LICENSE를 검토하고 상업적 통합에 대해 법률 자문을 구하세요.

10. FAQ

Q: 어떤 Node.js 버전이 필요한가요?
A: Node.js 22.16 이상입니다. npm i -g @actalk/inkos로 CLI를 설치하세요.

Q: InkOS는 영어로 작동하나요?
A: 중국어가 기본 언어이며 --lang en 플래그로 영어를 지원합니다. README.en.md를 참조하세요.

Q: 모델 설정이 제대로 작동하는지 어떻게 확인하나요?
A: inkos doctor를 실행하세요. 스튜디오에서 구성된 API 키는 .inkos/secrets.json에 저장됩니다.

Q: InkOS 1.x에서 프로젝트를 마이그레이션할 수 있나요?
A: 네. inkos work migrate --json으로 미리 보고 inkos work migrate --apply로 적용하세요.

Q: 로컬 모델을 사용할 수 있나요?
A: 네. Ollama와 LM Studio가 지원되며 사용자 지정 엔드포인트도 지원됩니다.

11. 빠른 링크

12. 요약

InkOS는 AI 지원 글쓰기를 지속적인 스토리 메모리를 갖춘 구조화되고 감사 가능한 워크플로로 전환하여 긴 프로젝트의 일관성을 유지합니다. 소설, 단편 소설 및 인터랙티브 월드에서 제어 가능한 장편 생성을 원하고 자신의 모델과 인터페이스를 선택할 자유를 원하는 작가, 게임 디자이너 및 개발자에게 적합합니다.