agynio/platform

AI 에이전트를 기업에 배포하세요. 안전하게.

당신은 에이전트를 구축했습니다. 이제 비밀 정보를 노출하거나, 예산을 초과하거나, 통제력을 잃지 않으면서 어떻게 나머지 회사 구성원들이 이를 사용하게 할 수 있을까요? Agyn은 에이전트를 노트북에서 기업 인프라로 이동시키며 기업에 필요한 통제 기능을 제공하는 오픈 소스 (open-source), Kubernetes 네이티브 (Kubernetes-native) 플랫폼입니다.

문제점	Agyn
에이전트가 개별 노트북에서 실행됨	귀하의 인프라에 중앙 집중식 배포
...

git clone https://github.com/agynio/bootstrap.git
cd bootstrap
./apply.sh

콘솔을 여세요. 조직 (org)을 생성하세요. 첫 번째 에이전트를 배포하세요.

테스트해 볼 수 있는 기성 함대 (fleet)를 원하시나요? agynio/demo-agent를 적용하세요.

— 단 한 번의 명령으로 지원 (support), 마케팅 (marketing), 데이터 엔지니어 (data-engineer) 에이전트를 프로비저닝 (provision)하는 Terraform 설정입니다.

프로덕션 (production) 설치는 Self-host 설치를 참조하세요.

클릭을 멈추세요. 에이전트 인프라를 버전 관리하세요.

resource "agyn_agent" "support" {
organization_id = agyn_organization.acme.id
name = "Support"
...

terraform init && terraform apply

모든 리소스에 대한 Terraform 프로바이더 (provider) 참조를 확인하세요.

각 에이전트는 일급 시민 (first-class citizen)입니다:

격리된 샌드박스 (Isolated sandbox)— 자체 컨테이너 (container), 파일 시스템 (filesystem), 환경 변수 (env vars), 비밀 정보 (secrets)
별도 컨테이너 내의 MCPs— 도구별 완전한 프로세스 격리 (process isolation)
내장된 관찰 가능성 (Observability built in)— 토큰 사용량 (token usage), 컴퓨팅 (compute), 활동 로그 (activity logs)
자동 확장 (Auto-scaling)— 에이전트가 필요에 따라 실행되고 유휴 상태 시 종료됨

전체 아키텍처 (architecture): docs/operate/architecture.md.

전체 문서는 docs/에 있습니다:

• 소개 (Introduction) — Agyn이란 무엇인지, 개념, 아키텍처 개요.
• Self-host 설치 (Self-host install) — 부트스트랩 (bootstrap), 프로덕션 설치, 업그레이드.
• 관리 (Administer) — 조직 (orgs), 에이전트 (agents), 모델 (models), 비밀 정보 (secrets), 러너 (runners), 앱 (apps)을 위한 콘솔 (Console) + Terraform.
• 사용 (Use) — 채팅 (chat), 파일 (files), 트레이싱 (tracing), 사용량 (usage), 포트 노출 (port exposure).
• 구축 및 확장 (Build & extend) — Gateway API, MCP 서버 (MCP servers), 에이전트 CLI (agent CLIs), 앱 (apps).
• 운영 (Operate) — 네트워킹 (networking), ID (identity), 확장 (scaling), 백업 (backups), 보안 (security).
• 참조 (Reference) — 용어 사전 (glossary), 서비스 카탈로그 (service catalog), 스키마 포인터 (schema pointers).
• 문제 해결 (Troubleshooting) — 증상별 진단 플레이북 (diagnostic playbook) + FAQ.

Agyn은 집중된 여러 저장소(repositories)로 나뉘어 있습니다. 가장 유용한 시작점은 다음과 같습니다:

저장소 (Repo)	설명
agynio/platform	이 저장소. 문서 허브 (Documentation hub).
agynio/architecture	단일 진실 공급원 (Source-of-truth) 아키텍처 및 제품 사양.
agynio/bootstrap	단일 명령으로 수행하는 로컬 설치 (k3d + Terraform).
agynio/platform-charts	프로덕션용 Helm 차트 (Helm charts).
agynio/api	모든 서비스에 대한 Protobuf 스키마 (schemas).
agynio/terraform-provider-agyn	Terraform 프로바이더 (provider).
agynio/agyn-cli	플랫폼 CLI (CLI).
agynio/console-app · chat-app · tracing-app	브라우저 UI (UIs).
agynio/agent-init-codex · agent-init-claude · agent-init-agn	에이전트 CLI 초기화 이미지 (init images).

설명이 포함된 전체 목록: docs/reference/service-catalog.md.

시작하기 좋은 방법:

• 코드를 다루기 전에 시스템을 이해하기 위해 아키텍처 문서 (architecture docs)를 읽어보세요.
• 작업하는 동안 질문이 있다면 Discord에 참여하세요.

AGPL-3.0