프로젝트 소개

Felix은 자체 호스팅 가능한 에이전트 허브입니다. 에이전트는 apiVersion felix/v1을 사용하는 YAML 매니페스트로 작성되며, 이 프로젝트는 내구 있는 파이버, 메모리, 스킬, 평가, 승인, 샌드박스를 갖춘 통치형 에이전트로 컴파일합니다. 이는 REST/SSE, OpenAI 호환 /v1 API, A2A JSON-RPC, MCP를 통해 이러한 에이전트를 노출하고, 감사, 승인, 계획, 작업, 매니페스트, 평가, 사용량, 메모리에 대한 관리 API를 제공합니다. 실시간 실행은 포크, 되감기 및 조향이 가능하며, 컴팩팅, 창 기반 또는 의미론적 컨텍스트를 위한 세션 전략이 있습니다. 스택에는 API 서비스, 작업자 및 스케줄러가 포함됩니다. pgvector가 포함된 Postgres가 시스템의 기록 저장소이며, Valkey는 캐시로 사용되고 파일시스템, S3 또는 GCS가 가능한 객체 저장소가 있습니다. 선택적 분석 웨어하우스 백엔드에는 DuckDB, ClickHouse, Doris가 포함됩니다. 배포 옵션에는 Docker Compose, Helm, AWS, GCP가 포함되며, 경량 기본 이미지와 클라우드 SDK, 관찰 가능성, 웨어하우스 지원을 위한 선택적 확장 기능이 제공됩니다. 거버넌스 기능은 인증, 승인, 감사 추적, 사용량 계측기, 보유 규제를 다룹니다. 관찰 가능성은 Prometheus 메트릭과 OpenTelemetry를 사용하며, 모델 호출은 GenAI 의미론적 관례를 따릅니다. 모델 공급업체에는 Anthropic, OpenAI, Ollama, Workers AI 및 여러 OpenAI 호환 벤더가 포함되며, 구성에 따라 논리적 모델 ID가 매핑됩니다. 모델 카탈로그는 각 패밀리에 대해 컨텍스트 창, 최대 출력, 가격, 매개변수, 추론 지원 및 모달리티를 포함합니다. Felix은 워크플로를 지정하는 대신 확장을 위해 설계되었습니다. 플러그인은 도구, HTTP 라우트, 크론 작업, 인증 모드, 속도 제한 키, 본문 한도, 자체 인증 마운트, 시작 후크, 감사/사용량 싱크 및 에이전트 루프 후크를 등록할 수 있습니다. 오픈 레지스트리를 통해 구성을 사용하여 패턴, 모델 공급업체, 객체 저장소, 비밀 번호 백엔드, 웨어하우스 백엔드, 임베더 백엔드, 검색 백엔드, 세션 전략 및 체크포인터를 선택할 수 있습니다. 에이전트 스킬은 코드 없이 SKILL.md 파일로 추가할 수 있습니다. 저장소에는 quick, deep, router, oss-only, hybrid-router, support, cowork, governed, contributor와 같은 번들된 매니페스트가 포함되어 있습니다. 빠른 시작 방법은 .env.example을 복사하고 make install 및 make up을 실행한 다음 생성된 로컬 API 키를 /chat 또는 OpenAI 호환 엔드포인트에 사용하는 것입니다. 이 프로젝트는 운영자가 관리하는 인프라에서 실행되며, 단일 벤더 SDK가 아닌 프로토콜을 사용하여 서비스 및 클라우드에 독립적입니다.