Radoss Universal Avatar

개인 소유 아바타를 위한 코드 없는 데스크톱 설정 레이어입니다.

NAAS는 아바타의 권위 기관입니다. Hermes는 눈에 보이는 설정 및 오케스트레이션 에이전트입니다. SQLite + FTS5는 로컬 표준 메모리 원장입니다. ReMe는 선택적 읽기 전용 프로젝션입니다. Ollama는 공개 제품에서 의도적으로 제외됩니다.

비기술 사용자용

릴리스 시 서명된 데스크톱 설치 프로그램을 사용하세요:

1. Radoss Universal Avatar를 설치하고 엽니다.

2. 아바타 이름을 지정합니다.

3. 개인정보 보호 모드를 선택합니다.

4. 내 아바타 설정을 클릭합니다.

5. 브라우저에서 계정 연결을 승인합니다. 코드나 토큰을 복사하지 마세요.

6. 마법사가 로컬 어댑터를 확인하면 지원되는 AI 호스트를 다시 열거나 새로 고칩니다.

데스크톱 마법사는 변경 전에 암호화된 로컬 백업을 생성하고 재시도, 롤백, 개인정보 보호, 연결 해제, 상태 및 보안 컨트롤을 제공합니다.

이 제품에는 의도적으로 서로 다른 세 가지 연결 경로가 있습니다:

• 코드 없는 사용자: 데스크톱 마법사와 브라우저 OAuth를 사용하며, 코드, 토큰 또는 구성 파일을 절대 복사하지 않습니다.

• 개발자: 스크립트 또는 저장소 기반 제어가 필요할 때 범용 CLI와 로컬 stdio MCP 어댑터를 사용합니다.

• 호스팅 AI 사용자: 브랜드 HTTPS MCP 게이트웨이를 사용한 후 해당 호스트의 자체 UI에서 최종 ChatGPT 또는 Claude 계정 연결을 완료합니다. Radoss는 로컬 파일만으로 호스트 계정이 연결되었다고 주장하지 않습니다.

Related MCP server: bodybridge

CLI 개발 경로

이 패키지는 공개 npm 게시를 위해 준비되었지만 아직 게시되지 않았습니다. 패키지 이름을 소유한 npm 계정을 인증한 후, 검증된 tarball을 다음 명령으로 게시하세요:

cd /path/to/radoss-universal-avatar
npm login
npm publish --access public

범용 CLI는 NAAS 소스 저장소와 별도로 유지 관리됩니다. 공개 소스 저장소는 innosaint-uche/radoss-universal-avatar입니다.

체크아웃에서 로컬 개발을 하려면:

cd /path/to/radoss-universal-avatar
node bin/radoss.mjs setup
node bin/radoss.mjs setup status
node bin/radoss.mjs doctor
# Validate the deployed HTTPS MCP gateway without exposing a token
node bin/radoss.mjs mcp conformance https://mcp.naavos.radoss.agency/mcp --bearer-env RADOSS_GATEWAY_TOKEN --status-tool avatar_get

CLI는 지원되는 로컬 대상을 자동으로 관리합니다:

• Codex: ~/.codex/config.toml

• Antigravity: ~/.gemini/config/mcp_config.json

• Hermes: ~/.hermes/profiles/avatar/config.yaml, 격리된 avatar 프로필

각 대상은 로컬 radoss_avatar MCP 서버를 받습니다. Hermes는 계속해서 눈에 보이는 오케스트레이터로 남습니다. 기본 Hermes 프로필은 자동으로 대체되지 않습니다.

연결 경계

로컬 에이전트는 보호된 stdio MCP를 사용합니다. 배포된 HTTPS Streamable HTTP 게이트웨이는 https://mcp.naavos.radoss.agency/mcp에서 OAuth, D1 기반 테넌트 소유자 강제, MCP 수명 주기 검사와 함께 제공됩니다. 독립적인 두 명의 실사용자 테넌트 승인은 별도의 공개 릴리스 게이트로 유지됩니다. 표준 Worker 오리진은 Hostinger/Coolify 브랜드 경로 뒤의 구현 세부 사항으로 유지됩니다. ChatGPT 및 Claude 계정 연결은 호스트 관리로 유지됩니다. 로컬 구성 파일은 온라인 ChatGPT 또는 Claude 연결을 증명할 수 없습니다.

호스팅 클라이언트에 필요한 원격 경계와 릴리스 증거는 docs/REMOTE_MCP_GATEWAY_CONTRACT.md에 정의되어 있습니다. 로컬 사이드카는 공개 커넥터로 직접 노출되어서는 안 됩니다.

검증된 로컬 Hugging Face 흐름은 브라우저 OAuth를 완료하고, 제공자 계정을 확인하고, macOS Keychain 헬퍼를 통해 자격 증명을 저장하며, Hermes의 OAuth 소유 캐시를 별도로 확인합니다. 설정 상태나 에이전트 구성에 토큰 값을 출력하거나 저장하지 않습니다.

검증

npm test
npm audit
npm pack --dry-run

증거 계약 및 릴리스 게이트는 docs/NO_CODE_SETUP.md를, Tauri 패키징 경계는 desktop-setup/README.md를 참조하세요.

현재 개발자, 로컬 검증 및 고객 릴리스 경계는 docs/RELEASE_STATUS.md를 참조하세요.

범용 QA

재사용 가능한 브라우저 및 라이브 표면 E2E는 중앙 외부 ~/.radoss-qa 하네스에 속합니다. 각 프로젝트는 실제 URL과 계약을 설명하는 작은 어댑터만 기여하며, 프로젝트에 Playwright, 브라우저 바이너리 또는 Rust를 추가하지 않습니다. Rust는 프로세스, IPC, 파일 시스템 또는 서명 증거가 필요할 때 중앙 Tauri 또는 아티팩트 어댑터에서만 사용됩니다. 범용 개발 환경 설치 후 로컬 하네스 README를 참조하세요.