<div align="center">
<img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/vite.svg" alt="ChengOS logo" width="168" height="168">
<h1 id="chengos">ChengOS</h1>
<hr>
<strong>시각적 AI 워크플로우 및 에이전트 런타임</strong>
웹, 모바일, 메시징, 터미널 클라이언트를 아우르는 지능형 워크플로우를 구축하고, 게시하며, 배포할 수 있습니다.
<br>
<br>
<img src="https://img.shields.io/badge/Backend-Rust-c96442?style=flat-square" alt="Rust backend">
<img src="https://img.shields.io/badge/Frontend-React-149eca?style=flat-square" alt="React frontend">
<img src="https://img.shields.io/badge/Protocol-MCP-6f42c1?style=flat-square" alt="MCP support">
<img src="https://img.shields.io/badge/Deployment-Native%20%7C%20Docker-2496ed?style=flat-square" alt="Native and Docker deployment">
<img src="https://img.shields.io/badge/License-Free%20to%20use-2da44e?style=flat-square" alt="Free to use">
<br>
<br>
Website · Live Demo · Overview · Screenshots · Quick start · Docs · 中文介绍
</div>
<a id="overview"></a>
개요 (Overview)
ChengOS는 AI 워크플로우와 에이전트를 구축, 실행 및 게시하기 위한 시각적 플랫폼입니다. Rust 기반의 워크플로우 엔진, 브라우저 기반 워크플로우 에디터, 다채널 채팅 애플리케이션, 터미널 클라이언트, 그리고 통합 배포 툴킷을 결합했습니다.
이 저장소는 ChengOS를 개발 환경 또는 프로덕션 환경에서 운영하는 데 필요한 배포 스크립트, 인프라 구성, 빌드된 애플리케이션 에셋 및 런타임 리소스를 제공합니다.
<a id="live-demo"></a>
라이브 데모 (Live demo)
두 서비스 모두 다음 공유 데모 계정을 사용하세요:
구축 가능한 기능 (What you can build)
- 재사용 가능한 노드와 서브플로우를 사용한 시각적 AI 및 자동화 워크플로우.
- 도구(tool), MCP 서버, 스킬(Skills)을 발견하고 호출할 수 있는 ReAct 에이전트.
- 웹, 모바일, 임베디드, 메시징 채널 채팅 애플리케이션.
- 로컬 문서, 스프레드시트, RAG 및 멀티모달 처리 파이프라인.
- 로컬 또는 원격 ChengOS 서버에 연결되는 터미널 기반 에이전트.
<a id="screenshots"></a>
스크린샷 (Screenshots)
| 애플리케이션 및 스킬 | 워크플로우 관리 |
|---|
| <img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/01.png" alt="ChengOS applications and Skills" width="100%"> | <img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/02.png" alt="ChengOS workflow management" width="100%"> |
| 시각적 워크플로우 에디터 | 메시징 채널 통합 |
|---|
| <img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/03.png" alt="ChengOS visual workflow editor" width="100%"> | <img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/04.png" alt="ChengOS messaging-channel integrations" width="100%"> |
배포 콘솔 (Deployment console)
<img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/05.png" alt="ChengOS deployment and management console" width="100%">
터미널 클라이언트 (Terminal client)
| 작업 공간 연결 | 에이전트와 채팅 |
|---|
| <img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/06.png" alt="ChengOS CLI workspace connection" width="100%"> | <img src="https://raw.githubusercontent.com/chengrouter/chengos/HEAD/deploy/config/image/07.png" alt="ChengOS CLI agent conversation" width="100%"> |
아키텍처 (Architecture)
ChengOS는 클라이언트-서버 아키텍처를 사용합니다. Rust 백엔드는 REST 및 WebSocket 인터페이스를 시각적 에디터, 애플리케이션 게이트웨이, 터미널 클라이언트에 노출합니다.
┌───────────────────────────────────┐
│ 백엔드 서비스 (chengflow) │
│ Rust DAG 엔진 / REST & WS │
...
| 컴포넌트 | 기술 | 책임 |
|---|
chengflow / cheng-api | Rust | DAG 실행, REST 및 WebSocket API, 샌드박싱, 자격 증명 관리, 다중 테넌시, 벡터 검색, 스케줄링. |
| ... | | |
주요 기능
시각적 워크플로우 및 에이전트
React Flow 캔버스에서 워크플로우를 구축하고, 속성 패널을 통해 노드를 구성하며, 상호작용적으로 테스트한 후 애플리케이션으로 게시할 수 있습니다. ReAct 에이전트는 다단계 도구 사용(multi-step tool use)을 지원하며, 서브플로우(subflows)와 배치 서브플로우(batch subflows)는 조합 및 병렬 처리를 가능하게 합니다.
네이티브 MCP 지원
tools/mcp_hub를 통해 Stdio, SSE 또는 HTTP로 MCP 서버에 연결합니다.- 워크플로우와 에이전트로부터 도구(tools), 프롬프트, 리소스를 동적으로 검색합니다.
- 웹 UI에서 연결을 관리하거나 환경 설정을 통해 사전 설정된 구성을 주입할 수 있습니다.
내장 스킬 임포터(Skill importer)는 자연어 요구사항, 웹 페이지 또는 API 문서, Git 저장소, 표준 SKILL.md 파일 및 ZIP 패키지로부터 실행 가능한 스킬 패키지를 생성할 수 있습니다. 가져온 스킬은 파싱(parsing), 검증(validation), 검토(review), 안전 쓰기(safe writing), 그리고 핫 리로드(hot reload) 과정을 거칩니다.
자격 증명 격리 (Credential isolation)
비밀 값(Secrets)은 워크플로우, 스킬 또는 스크립트에 내장되는 대신 백엔드 자격 증명 금고(credential vault)에 저장됩니다. 도구와 스킬은 실행 시점에만 자격 증명을 받으며, 원시 값을 LLM 프롬프트 컨텍스트에서 제외합니다. 샌드박싱과 user_id 격리는 추가적인 경계를 제공합니다.
로컬 문서, 스프레드시트 및 RAG
ChengOS는 로컬 Word(.docx) 및 스프레드시트(.xlsx 또는 그리드) 작업 공간을 포함합니다. 에이전트는 서류 및 테이블 노드를 통해 제3자 온라인 오피스 스위트를 요구하지 않고도 콘텐츠를 읽고, 형식 지정하고, 업데이트하며, 생성할 수 있습니다. RAG 노드는 청킹(chunking), 인덱싱(indexing), 검색(retrieval), 그리고 벡터 검색을 다룹니다.
다중 채팅 진입점
- 워크플로우 에디터 내 임베디드 채팅: 테스트 및 반복 작업을 위한 기능입니다.
- 웹, H5, PWA, 그리고 WhatsApp, Telegram, Slack, WeCom, DingTalk, ChengApp과 같은 메시징 채널을 지원합니다.
- 로컬 개발 및 원격 서버를 위한 경량 터미널 클라이언트도 제공됩니다.
<a id="quick-start"></a>
빠른 시작
대화형 이중 언어 관리 콘솔을 실행하세요:
이 콘솔을 사용하면 모듈을 설치, 시작, 중지, 재시작, 업데이트, 검사(inspect), 또는 제거할 수 있습니다. 또한 CLI를 독립적으로 설치하고, 시스템 명령어 바로가기를 생성하며, 영어와 중국어 간에 전환하는 것도 가능합니다.
네이티브 배포
API 및 정적 웹 애플리케이션을 호스트에서 직접 실행하세요:
./chengos.sh install --mode native --db-install-mode managed-process --with api,ui,app,cli
./chengos.sh start
./chengos.sh status
데이터베이스 설치 모드:
managed-process (기본값): root 접근 권한 없이 PostgreSQL, Valkey, Qdrant를 비특권 프로세스로 실행합니다.system-service: 시스템 패키지 관리자를 통해 데이터베이스를 systemd 서비스로 설치하며 sudo가 필요합니다.
Docker Compose 배포
./chengos.sh install --mode docker --with api,ui,app,cli
./chengos.sh start
./chengos.sh stop
latest 대신 정확한 릴리스 버전을 지정하세요. 네 개의 ChengOS 이미지는 모두 .env 파일의 CHENGOS_VERSION 값에서 태그를 가져옵니다:
latest는 첫 설치 편의 기능일 뿐입니다. 재현 가능한 프로덕션 버전이 아니며, 업데이트나 롤백 대상이 절대 아닙니다.
버전, 업데이트 및 롤백
./chengos.sh status
./chengos.sh update
./chengos.sh rollback
릴리스 운영 가이드(Release Operations Guide)에서는 아티팩트 검증, 업데이트 및 롤백 절차 — 데이터베이스 마이그레이션으로 인해 자동 롤백이 안전하지 않은 경우를 포함하여 — 에 대한 내용이 문서화되어 있습니다.
독립형 CLI 및 원격 접속
cheng 터미널 클라이언트만 설치하십시오:
로컬 연결을 http://127.0.0.1:19225로 선택하거나, 원격 ChengOS 서버의 URL을 입력하십시오. 설정이 완료되면, 아무 터미널에서나 클라이언트를 시작할 수 있습니다:
워크플로우 도구 세트
| 카테고리 | 대표 도구 |
|---|
| 코드 및 셸 | tools/code_shell, tools/code_python, tools/code_js |
| ... | |
배포 레이아웃
deploy/
├── chengos.sh # 이중 언어 설치 프로그램 및 관리 콘솔
├── generate-env.sh # 통합 환경 생성기
...
기본 포트
| 서비스 | 포트 | 환경 변수 | 목적 |
|---|
API 백엔드 (cheng-api) | 19225 | PORT=19225 | REST 및 WebSocket API |
| ... | | | |
라이선스
ChengOS는 현재 사용은 무료이지만 오픈 소스는 아닙니다. 개인 및 상업용 사무 자동화에 사용될 수 있지만, 소스 코드는 공개적으로 이용할 수 없습니다.
계획된 에디션:
- Community Edition — 무료이며, 현재의 핵심 자동화 기능을 제공합니다.
- Enterprise Edition — 유료이며, 팀 협업, 권한 관리, 분석 및 추가 엔터프라이즈 기능을 제공합니다.
비즈니스 문의나 엔터프라이즈 상담은 [email protected]으로 연락 주십시오.
---<a id="中文介绍"></a>
ChengOS 중국어 소개
<div align="center">
시각적 AI 데이터 처리 및 에이전트 워크플로우 플랫폼
온라인 체험 · 제품 개요 · 시스템 아키텍처 · 빠른 시작 · 문서 · 영어 돌아가기
</div
<a id="产品概览"></a>
제품 개요
ChengOS는 AI 워크플로우 및 에이전트를 구축, 실행 및 배포하는 데 사용되는 시각적 플랫폼입니다. 이 시스템은 Rust 워크플로우 엔진, 브라우저 기반 워크플로우 편집기, 다채널 채팅 애플리케이션, 터미널 클라이언트 및 통합 배포 관리 도구를 통합합니다.
본 저장소는 개발 환경과 운영 환경에서 ChengOS를 실행하는 데 필요한 배포 스크립트, 인프라 구성, 애플리케이션 빌드 산출물 및 실행 리소스를 제공합니다.
<a id="在线体验"></a>
온라인 체험
서비스
두 체험 주소 모두 다음 공용 데모 계정을 사용합니다:
ChengOS를 사용하여 구축할 수 있는 것들:
- 재사용 가능한 노드 및 서브 워크플로우로 구성된 시각화 AI 자동화 프로세스.
- 도구, MCP 서비스 및 Skills를 발견하고 호출하는 ReAct 에이전트.
- 웹(Web), 모바일(Mobile), 임베디드 컴포넌트 및 실시간 메시징 채널을 위한 채팅 애플리케이션.
- 로컬 문서, 스프레드시트, RAG 및 다중 모드 데이터 처리 프로세스.
- 로컬 또는 원격 ChengOS 서비스에 연결되는 터미널 에이전트.
제품 인터페이스, 배포 콘솔 및 CLI 효과는 앞서의 제품 스크린샷을 참조하십시오.
<a id="시스템아키텍처"></a>
시스템 아키텍처
ChengOS는 클라이언트/서버 아키텍처를 채택했습니다. Rust 백엔드는 REST API와 WebSocket을 통해 시각화 에디터, 애플리케이션 게이트웨이 및 터미널 클라이언트에 통합 서비스를 제공합니다.
| 컴포넌트 | 기술 스택 | 주요 책임 |
|---|
chengflow / cheng-api | Rust | DAG 워크플로우 실행, REST 및 WebSocket API, 샌드박스(Sandbox), 자격 증명(Credential), 멀티테넌시(Multi-tenancy), 벡터 검색 및 작업 스케줄링. |
| ... | | |
핵심 기능
시각화 워크플로우와 에이전트
React Flow 캔버스를 통해 워크플로우를 오케스트레이션하고, 속성 패널에서 노드를 구성하며, 실시간으로 테스트하여 애플리케이션으로 배포할 수 있습니다. ReAct 에이전트는 다단계 도구 호출을 지원하며, 서브 워크플로우와 배치(Batch) 서브 워크플로우는 프로세스 재사용 및 병렬 처리를 지원합니다.
MCP 네이티브 지원
tools/mcp_hub를 통해 Stdio, SSE 또는 HTTP로 MCP 서비스를 사용합니다.- 워크플로우와 에이전트는 도구(Tool), 프롬프트(Prompt) 및 리소스를 동적으로 발견할 수 있습니다.
- 관리 백엔드에서 연결을 유지 관리하거나 환경 설정을 통해 사전 정의된 내용을 일괄 주입할 수 있습니다.
다중 형식 Skill 가져오기
내장된 Skill 임포터는 자연어 요구사항, 웹페이지 또는 API 문서, Git 저장소, 표준 SKILL.md 파일 및 ZIP 압축 파일에서 실행 가능한 Skill을 생성하는 것을 지원합니다. 가져오기 프로세스에는 파싱(Parsing), 규격 검증(Validation), 수동 검토(Manual Review), 안전 쓰기(Safe Write) 및 핫 로딩(Hot Loading)이 포함됩니다.
자격 증명 보안 격리
민감한 자격 증명은 백엔드 자격 증명 저장소에 통합 저장되며, 워크플로우, Skill 또는 스크립트에 기록되지 않습니다. 도구와 Skill은 실행 단계에서만 자격 증명을 얻으며, 실제 값은 LLM 프롬프트 컨텍스트로 들어가지 않습니다. 시스템은 또한 샌드박스와 user_id를 통해 추가적인 격리를 구현합니다.
로컬 문서, 스프레드시트 및 RAG
ChengOS는 Word(.docx) 및 스프레드시트(.xlsx 또는 그리드) 작업 공간을 내장하고 있습니다. 에이전트는 타사 온라인 오피스 플랫폼에 의존할 필요 없이 문서 및 스프레드시트 노드를 통해 콘텐츠를 읽고, 형식화하고, 수정하고, 생성할 수 있습니다. RAG 노드는 문서 분할(Chunking), 인덱싱(Indexing), 검색(Retrieval) 및 벡터 검색 기능을 제공합니다.
다양한 채팅 진입점
- 실시간 테스트 및 디버깅에 적합한 워크플로우 에디터 내 임베디드 채팅 창.
- 웹(Web), H5, PWA뿐만 아니라 WhatsApp, Telegram, Slack, 기업 위챗(Enterprise WeChat), 딩딩(DingTalk), ChengApp 등의 메시지 채널.
- 로컬 개발 및 원격 서버를 위한 경량 터미널 클라이언트.
<a id="빠른시작"></a>
빠른 시작
중국어/영어 양방향 인터랙티브 관리 콘솔을 실행합니다:
관리 콘솔은 모듈 설치, 시작, 중지, 재시작, 업데이트, 상태 확인 및 제거를 지원하며, CLI만 개별적으로 설치하거나 시스템 바로가기 명령을 생성하고 중국어/영어 인터페이스를 전환할 수도 있습니다.
네이티브 배포
호스트 머신에서 API와 프론트엔드 정적 애플리케이션을 직접 실행합니다:
./chengos.sh install --mode native --db-install-mode managed-process --with api,ui,app,cli
./chengos.sh start
./chengos.sh status
데이터베이스 설치 모드:
managed-process (기본값): root 권한이 필요 없이 일반 사용자 프로세스로 PostgreSQL, Valkey 및 Qdrant를 실행합니다.system-service: 시스템 패키지 관리자를 통해 데이터베이스를 설치하고 systemd 서비스로 등록하며, sudo가 필요합니다.
Docker Compose 배포
./chengos.sh install --mode docker --with api,ui,app,cli
./chengos.sh start
./chengos.sh stop
버전을 특정 버전으로 고정하는 것이 좋으며, latest를 사용하지 마십시오: 네 개의 ChengOS 이미지는 .env 파일의 CHENGOS_VERSION에 의해 태그가 통일됩니다.
latest는 최초 설치 시 편리한 기본값일 뿐이며, 재현 가능한 프로덕션 버전이 아니며, 업데이트나 롤백의 대상도 결코 아닙니다.
버전, 업데이트 및 롤백
./chengos.sh status
./chengos.sh update
./chengos.sh rollback
전체 배포, 아티팩트(制品) 검증, 업데이트 및 롤백 프로세스(
