English

中文

Documentation

Docker Pulls

Codecov (with branch)

Nexent는 Harness Engineering 원칙을 기반으로 생산 수준(production-grade) AI 에이전트를 자동 생성하는 제로코드 플랫폼입니다. 이 플랫폼은 내장된 제약 조건, 피드백 루프, 제어 평면과 함께 통합 도구, 스킬, 메모리, 오케스트레이션을 제공하며, 복잡한 드래그 앤 드롭이나 별도의 오케스트레이션 없이 순수 언어만 사용하여 원하는 모든 에이전트를 개발할 수 있습니다.

하나의 프롬프트로 무한한 도달 범위를. (One prompt. Endless reach.)

🚀 지금 바로 시작하기 (Get Started Now)

⭐ 시작하기 전에, GitHub에서 별점(star)을 눌러주세요 — 여러분의 지원이 저희를 앞으로 나아가게 합니다!

자체 배포 (Deploy on Your Own)

Nexent를 로컬 또는 사설 인프라에서 실행해야 하는 경우, 두 가지 배포 옵션을 제공합니다:

시스템 요구 사항 (System Requirements)

참고: 권장 구성은 프로덕션 환경에서 최적의 성능을 보장합니다.

Docker 배포 (개인/소규모 팀에 권장) (Docker Deployment (Recommended for Individuals/Small Teams))

대부분의 사용자에게 빠르고 간단합니다. 전제 조건: Docker 24+ 및 Docker Compose v2+:

git clone https://github.com/ModelEngine-Group/nexent.git
cd nexent
bash deploy.sh docker

루트(root)의 deploy.sh는 대상 배포 스크립트로만 포워딩합니다. 네이티브 Docker 구현은 bash deploy/docker/deploy.sh입니다. Docker와 Kubernetes 배포 스크립트는 동일한 배포 구성 모델을 공유합니다. 대화형 실행(Interactive runs)에서는 컴포넌트 선택, 포트 정책, 이미지 소스에 대한 Bash TUI 메뉴가 표시됩니다. infrastructure는 필수이며, application, data-process, 그리고 supabase는 기본적으로 선택되며 더 작은 배포를 원할 때 비활성화할 수 있습니다. 이전 TUI 단계로 돌아가려면 b/Backspace를 사용하고 종료하려면 q를 사용하십시오. --defaults를 사용하면 TUI 단계를 건너뛰고 저장된 deploy.options 또는 내장 기본값으로 배포합니다. 비대화형 실행(Non-interactive runs)에서도 동일한 선택을 --version, --components, --port-policy development|production, 그리고 --image-source general|mainland|local-latest를 사용하여 전달할 수 있습니다. 성공적인 배포는 민감하지 않은 선택 사항들을 각 배포 디렉터리의 deploy.options에 저장하여 다음 실행에서 재사용합니다.

Docker와 Kubernetes 모두 런타임 구성 파일로 deploy/env/.env를 사용합니다. 기존의 deploy/env/.env는 그대로 유지됩니다. 만약 존재하지 않는다면, 배포 스크립트는 먼저 docker/.env를 재사용하고, 그다음 deploy/env/.env.example에 의존합니다. 모니터링 관련 설정은 deploy/env/monitoring.env.example에서 deploy/env/monitoring.env로 생성됩니다.

Docker 제거는 bash uninstall.sh docker를 통해 처리됩니다. 데이터 볼륨을 보존하거나 삭제할 수 있습니다: 대화형으로 실행하면서 --delete-volumes true|false를 전달하거나, 컨테이너와 영구 데이터를 제거하려면 bash uninstall.sh docker delete-all을 사용하십시오.

오프라인 이미지 패키지는 bash build.sh --package --target docker --compress true 또는 bash deploy/offline/build_offline_package.sh --target docker --compress true를 사용하여 빌드할 수 있습니다. 이 패키지에는 이미지 tar 파일, load-images.sh, push-images.sh, 루트 디렉토리의 배포/제거 진입점(entrypoints), 배포 스크립트, SQL 파일, manifest.yaml, 그리고 checksums.txt가 포함됩니다. 패키지 배포는 저장된 deploy.options 또는 내장 기본값을 사용하며 TUI를 열 필요가 없습니다. 대화형으로 구성하려면 --config를 추가하십시오. 대상 호스트에서 bash deploy.sh --load-images docker ...로 배포하거나, bash deploy.sh --push-images --image-registry-prefix registry.example.com/nexent docker ...를 사용하여 로드된 이미지를 내부 레지스트리로 푸시하고 해당 이미지 접두사로 배포할 수 있습니다. --push-images가 접두사 없이 사용될 경우, deploy.sh는 push-images.sh가 레지스트리 사용자 이름과 비밀번호를 요청하기 전에 이를 묻습니다.

자세한 배포 지침은 Docker 설치를 참조하십시오.

Kubernetes 배포 (엔터프라이즈 프로덕션용)

고가용성(high availability) 및 탄력적 확장(elastic scaling)이 필요한 엔터프라이즈 시나리오에 이상적입니다. 전제 조건: Kubernetes 1.24+ 및 Helm 3+:

git clone https://github.com/ModelEngine-Group/nexent.git
cd nexent
bash deploy.sh k8s

네이티브 Kubernetes 구현은 bash deploy/k8s/deploy.sh입니다. 이 스크립트는 Elasticsearch, PostgreSQL, Redis, MinIO를 위한 nexent-infrastructure, 그리고 인프라와 Elasticsearch API 키가 준비된 후 애플리케이션 서비스를 위한 nexent라는 두 개의 독립적인 Helm 릴리스(releases)를 설치합니다. --release-scope all|infrastructure|nexent를 사용하여 두 릴리스 모두 또는 각각을 개별적으로 운영할 수 있습니다. 이 스크립트는 deploy/env/.env 파일을 읽고 명시적인 Helm ConfigMap 및 Secret 오버라이드(overrides)를 생성합니다. PVC 동작을 제어하려면 --persistence-mode local|dynamic|existing, --storage-class/--sc, --local-path, --local-node-name, 그리고 --existing-claim-prefix를 사용하십시오.

Kubernetes 제거는 bash uninstall.sh k8s로 처리됩니다. 기본적으로 먼저 nexent를, 그다음 nexent-infrastructure를 제거합니다. 동일한 --release-scope 옵션은 애플리케이션만 제거하거나 의존성이 보호된 인프라스트럭처를 제거하는 것을 지원합니다.

Kubernetes 오프라인 패키지는 --target k8s 또는 --target all을 사용하여 동일한 빌더를 사용합니다. 이미지가 필요한 모든 클러스터 노드에서 load-images.sh를 실행하거나, 같은 버전, 이미지 소스, 그리고 이미지 레지스트리 접두사를 사용하여 배포하기 전에 내부 레지스트리로 이미지를 푸시하려면 --push-images --image-registry-prefix registry.example.com/nexent를 사용하세요.

자세한 배포 지침은 Kubernetes 설치를 참조하십시오.

✨ 핵심 기능 (Core Features)

Nexent는 강력한 AI 에이전트를 구축하기 위한 포괄적인 기능 세트를 제공합니다:

🤝 커뮤니티 참여 (Join Our Community)

빠르게 가고 싶다면 혼자 가라; 멀리 가고 싶다면 함께 가라.

저희는 Nexent v2.0을 출시했습니다! 이는 v1.0에서 업그레이드된 포괄적인 버전으로, A2A 프로토콜 지원, 점진적 스킬 공개(progressive Skill disclosure), 계층형 메모리 메커니즘(layered memory mechanism), 다중 테넌시를 갖춘 사용자 관리, 에이전트 버전 관리, 에이전트 마켓플레이스 등을 특징으로 합니다.

• **🗺️ 기능 맵 (Feature Map)**을 확인하여 현재 및 향후 기능을 탐색하세요.
• 🔍 현재 빌드를 사용해 보고 Issues 탭에 아이디어나 버그를 남겨주세요.

로마는 하루아침에 세워지지 않았다.

저희의 비전이 마음에 든다면, **기여 가이드 (Contribution Guide)**를 통해 참여하여 저희와 함께 Nexent를 만들어가세요.

초기 기여자들의 노고는 결코 간과되지 않을 것입니다: 특별 배지, 기념품(swag) 및 기타 실질적인 보상을 통해 Nexent를 구현하는 데 도움을 준 선구자들에게 감사할 것을 약속드립니다.

무엇보다도, 저희에게 필요한 것은 가시성입니다. ⭐ 별표를 누르고 저장하고, 친구들과 공유하며, 더 많은 개발자들이 Nexent를 발견하도록 도와주세요. 여러분의 클릭 한 번이 프로젝트에 새로운 인력을 유입시키고 모멘텀을 계속 성장시키는 원동력이 됩니다.

📖 다음 단계 (What's Next)

더 깊이 탐험할 준비가 되셨나요? 주요 문서 진입점은 다음과 같습니다:

• 빠른 시작(Quick Start) — 시스템 요구 사항 및 배포 가이드
• 핵심 기능(Core Features) — 포괄적인 기능 문서
• 사용자 가이드(User Guide) — 에이전트 개발 및 사용법
• 개발자 가이드(Developer Guide) — 소스 코드 빌드 및 맞춤 설정
• FAQ — 일반적인 질문 및 문제 해결

📄 라이선스 (License)

Nexent는 MIT License에 따라 라이선스가 부여됩니다.