# AMEVA Open-Source Foundation (AOSF) - Full Machine-Readable Specification
> Concatenation of the foundation's public documents for LLM / AI-agent consumption.
> Sources: llms.txt, CHARTER.md, GOVERNANCE.md, INCUBATION_POLICY.md, SPONSORSHIP.md
========================================================================
## llms.txt (overview) (source: foundation/llms.txt)
========================================================================
# AMEVA Open-Source Foundation (AOSF) - Machine-Readable Specification
> Official LLM & AI Agent Context for AMEVA Open-Source Foundation (AOSF)
## 1. Organization Overview
- **Name**: AMEVA Open-Source Foundation (AOSF / AMEVA 오픈소스 재단)
- **Mission**: "Democratizing On-Device AI & Autonomous Systems Without Cloud Egress Dependency"
- **Governance**: Apache-Style Meritocracy (Board, PMC, Committers, Contributors)
- **Founder & Chair**: Eunho Kim (@uno-km)
- **Licensing**: Apache 2.0 / MIT standard
- **Official Web Portal**: https://uno-km.vercel.app/foundation/
- **Central Repository**: https://github.com/uno-km/uno-km
## 2. 3-Tier Project Portfolio Specification
### Tier 1: Flagship Top-Level Projects (TLP)
- **AMEVA-Workstation**: 100% On-device WebGPU local AI (Qwen2.5 0.5B/1.5B/7B), 3-sec MapReduce PDF/DOCX doc reader & editor, video cutter, 1-sec AI background removal, audio silence auto-cut. Web App: https://ameva-workstation-web-core.vercel.app/
- **AMV-Playwright**: Non-root Chromium browser automation on Android Termux (ARM64 Bionic). PyPI: `amv-playwright`, npm: `amv-playwright`.
- **AMV-Diffusion**: On-device ARM64 native Stable Diffusion runtime for Android without root. PyPI: `amv-diffusion`, npm: `amv-diffusion`.
### Tier 2: Incubating Projects
- **AMEVA-Forge**: Client-compute offloaded architecture Browser-Native WebGPU Autograd Engine with PyTorch compatibility and WGSL compute shaders.
- **Termux-Torch**: Android Bionic native lightweight Tensor & Autograd engine.
- **Termux-Whisper**: On-device Korean speech recognition and LoRA fine-tuning for edge hardware.
### Tier 3: Labs & Research
- **Dead Internet Theatre**: Docker-based autonomous multi-agent social simulation.
- **AMEVA Agent Orchestra**: Hierarchical multi-agent orchestration (Nobles & Workers).
- **AMV-MCP-Hub**: 100% browser Pyodide WASM isolated execution sandbox.
- **AMEVA-Multi-CLI**: Recursive multi-split terminal workbench with 80 FPS smart PTY.
- **BitNet**: 1-bit quantization (1.58-bit) LLM ARM NEON / I2_S kernel contributions.
## 3. Governance & Policy Files
- Charter: https://uno-km.vercel.app/foundation/charter.html
- Governance: https://uno-km.vercel.app/foundation/governance.html
- Incubation: https://uno-km.vercel.app/foundation/incubation.html
- Sponsorship: https://uno-km.vercel.app/foundation/sponsorship.html
========================================================================
## CHARTER (source: foundation/CHARTER.md)
========================================================================
# Official Charter of the AMEVA Open-Source Project
AMEVA 오픈소스 프로젝트 공식 헌장
---
## 1. 프로젝트 소개 및 설립 목적 (About AMEVA)
**AMEVA Open-Source Foundation (AOSF)**은 개발자 **@uno-km (김은호)**이 1인 인디 시스템 엔지니어로서 직접 설립하고, 모든 소스코드를 홀로 유지보수·관리하는 온디바이스 AI 연구 프로젝트입니다.
우리는 거창한 관료주의나 형식적인 재단 허세를 배격합니다.
우리의 사명은 오직 하나입니다:
> **"빅테크의 비싼 클라우드 API 토큰 과금에 종속되지 않고, 누구나 주머니 속 스마트폰과 서랍 속 구형 기기로 100% 자립 구동하는 로컬 AI를 누리게 한다."**
---
## 2. 지적재산권, 저작권 및 사용 가이드 (Code Ownership & Ethics)
1. **지적재산권의 귀속 (My Code, My Craft)**:
- 본 저장소의 모든 소스코드, 셰이더 커널, 빌드 스크립트, 아키텍처 문서는 개발자 uno-km의 밤샘 땀과 피로 직접 깎아 만든 소중한 지적 자산입니다.
2. **오픈소스 사용 (Apache-2.0 / MIT)**:
- 개인 연구, 학습, 비영리 프로젝트에는 오픈소스 라이선스에 따라 언제나 자유롭게 사용하실 수 있습니다.
3. **무단 복제 및 표절 금지 (No Plagiarism)**:
- 출처 표기 없이 코드를 무단 도용하거나, 자신의 성과인 양 재포장하여 배포하는 행위는 엄격히 금지합니다. 무단 복제 적발 시에는 DMCA 게시 중단 요청 및 법적 조치 등 **매우 안타까운 일**이 발생할 수 있습니다.
4. **상업적 사용 및 협업 문의**:
- 기업 도입, 제품 탑재, 맞춤형 셰이더 포팅 등 상업적 연동이 필요하신 분은 사전에 이메일(**`amv.foundation.kr@gmail.com`**)로 정중히 연락 주시면 감사하겠습니다.
---
## 3. 주권 연구 자산 및 능동 방어망의 비공개 원칙 (Sovereign Vault & Active Defense)
1. **오픈소스 런타임 표준 지향**:
- AOSF는 사용자가 자신의 물리 단말기에서 인공지능을 직접 소유하고 실행할 수 있는 표준 런타임과 도구(`termux-*` 및 `AMEVA-Runtime`)를 오픈소스 공공재(Public Commons)로 보급합니다.
2. **능동 방어 및 보안 자산의 전략적 비공개(OPSEC)**:
- 악의적 AI 크롤러의 무단 데이터 수탈을 차단하는 **Sentinel 능동 방어망, 카나리 허니팟 트랩(Canary Trap), 적대적 탈옥 방어 필터, Dead Internet 사회실험 원시 텔레메트리**는 방어 체계의 무력화를 방지하기 위해 비공개 주권 볼트(Sovereign Vault) 체계로 엄격히 통제·보호합니다.
- 이는 오픈소스 정신에 위배되는 것이 아니며, OpenSSF 및 국제 보안 표준에 부합하는 정당한 방어적 주권 행사입니다.
---
## 4. 참여와 협업: 함께 토론하고 발전해 나갑시다 (Collaboration)
- 거창한 위원회나 의결 정족수 같은 모래주머니는 없습니다.
- 프로젝트가 마음에 드셨다면 **GitHub Star(⭐️)**를 눌러 응원해 주십시오.
- 버그를 발견하셨거나 개선 아이디어가 있다면 언제든 **GitHub Issues**와 **Pull Requests (PR)**로 쓴소리와 피드백을 남겨주십시오. 열린 마음으로 치열하게 토론하고 코드를 더 가볍고 빠르게 발전시켜 나가겠습니다.
---
**AMEVA Open-Source Foundation (AOSF)**
*Crafted with raw passion by @uno-km. Powered by real physical silicon.*
========================================================================
## GOVERNANCE (source: foundation/GOVERNANCE.md)
========================================================================
# AOSF Governance & Community Guidelines
AMEVA 프로젝트 운영 원칙 및 커뮤니티 가이드
---
## 1. 운영 및 의사결정 원칙 (Direct & Honest Governance)
AMEVA 오픈소스 프로젝트는 복잡한 투표 정족수, 거창한 위원회 선거 같은 형식적인 관료주의를 철저히 배제합니다.
1. **메인테이너 책임제 (Core Maintainership)**:
- 본 프로젝트는 설립자이자 메인테이너인 **@uno-km (김은호)**이 소스코드 리뷰, 릴리즈 태깅, 기술적 방향성을 직접 책임지고 관리합니다.
2. **실기기 성능이 법이다 (Silicon Truth Over Politics)**:
- 말이나 정치가 아닌, 실제 안드로이드 단말기와 에지 디바이스에서 측정된 성능 지표, 지연 시간, 메모리 안정성이 모든 기술적 결정의 기준입니다.
---
## 2. 주권형 이원화 오픈소스 거버넌스 규정 (Dual-Track Sovereign Governance Policy)
AMEVA Open-Source Foundation (AOSF)은 전 세계 개발자의 온디바이스 자립을 지원하는 **공공 오픈소스 생태계(Public Commons)**와 악의적 데이터 수탈 및 시스템 침해를 차단하는 **주권형 연구 볼트(Sovereign Vault)**의 이원화 거버넌스를 엄격히 준수합니다.
```mermaid
graph LR
classDef main fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#f8fafc;
classDef pub fill:#1e293b,stroke:#22c55e,stroke-width:1.5px,color:#f8fafc;
classDef priv fill:#1e293b,stroke:#f43f5e,stroke-width:1.5px,color:#f8fafc;
AOSF["AOSF 이원화 거버넌스"]:::main
AOSF --> T1["Track 1: Public Commons
(100% 완전 공개 / Apache-2.0)
- 14대 온디바이스 런타임 및 SDK
- 시스템 핸드북 26강 & 벤치마크"]:::pub
AOSF --> T2["Track 2: Sovereign Research Vault
(작전 보안 OPSEC 비공개 격리)
- Sentinel 능동 방어망 및 허니팟
- Dead Internet 원시 인격 벡터 DB"]:::priv
```
1. **Track 1: Public Commons (공공 오픈소스 계층 - Apache 2.0)**:
- `AMEVA-Runtime`, `amv-stt`, `amv-diffusion`, `amv-bitnet`, `amv-vision`, `amv-playwright`, `AMEVA-Forge` 등 온디바이스 AI 런타임 및 개발자 도구 일체는 100% 오픈소스로 투명하게 개방합니다.
2. **Track 2: Sovereign Research Vault (주권 연구 및 능동 방어 격리 계층)**:
- 무단 크롤러 및 적대적 AI 스크래퍼를 차단하는 **Sentinel 능동 방어망, 카나리 허니팟 트랩(Canary Trap), Dead Internet 사회실험 원시 텔레메트리 DB 및 인격 동역학 조작 가중치**는 작전 보안(OPSEC) 원칙에 따라 외부에 공개하지 않고 프라이빗 볼트에 격리합니다.
- 방어 트랩 시그니처와 허니팟 코드를 공개하는 것은 공격자에게 우회 경로를 제공하는 자폭 행위이므로, 이는 OpenSSF 및 CNCF 보안 표준에 따른 정당하고 합법적인 비공개 보안 조치입니다.
---
## 3. 기여 및 피드백 가이드 (How to Contribute)
우리는 스스로를 완벽하다고 포장하지 않습니다.
우리는 언제나 커뮤니티의 솔직한 피드백과 쓴소리를 진심으로 환영합니다.
1. **버그 리포트 & 이슈 제기**:
- 단말기에서 크래시가 나거나 비효율적인 부분이 보인다면 언제든 GitHub Issues를 열어 거침없이 지적해 주십시오. 달게 받고 즉시 패치하겠습니다.
2. **Pull Requests (PR)**:
- 더 가벼운 NEON 어셈블리 커널, 셰이더 최적화, 오탈자 수정 등 모든 기여를 환영합니다. 함께 토론하고 코드 머지를 진행합니다.
3. **GitHub Star(⭐️)로 응원하기**:
- 이 프로젝트가 유용하셨다면 깃허브 스타를 눌러 힘을 보태주십시오. 1인 인디 개발자에게 가장 큰 원동력이 됩니다.
---
## 3. 연락처 및 협업 (Contact)
- **GitHub**: [github.com/uno-km](https://github.com/uno-km)
- **Email**: [amv.foundation.kr@gmail.com](mailto:amv.foundation.kr@gmail.com)
- **Tech Blog**: [uno-kim.tistory.com](https://uno-kim.tistory.com/)
---
**AMEVA Open-Source Foundation (AOSF)**
*Simple. Honest. Powerful On-Device AI.*
========================================================================
## INCUBATION POLICY (source: foundation/INCUBATION_POLICY.md)
========================================================================
# AOSF Project Incubation & Graduation Policy
AMEVA 재단 3-Tier 프로젝트 인큐베이션 및 승격 정책
Version: 1.0.0
Standard: Open-Source Project Lifecycle
---
## 1. Overview (개요)
AMEVA Open-Source Foundation (AOSF)은 산하 모든 오픈소스 프로젝트의 코드 품질, 커뮤니티 건강성, 릴리즈 신뢰성을 보장하기 위해 체계적인 3단계 인큐베이션 라이프사이클(3-Tier Project Lifecycle)을 운영합니다.
```text
┌─────────────────────────┐
│ Tier 3: Labs │ 아이디어 검증, 선행 아키텍처 연구, 프로토타입 개발
└───────────┬─────────────┘
│ [인큐베이션 진입 심사]
▼
┌─────────────────────────┐
│ Tier 2: Incubating │ API 규격 표준화, CI/CD 자동화, 크로스 런타임 검증
└───────────┬─────────────┘
│ [TLP 플래그십 승격 심사]
▼
┌─────────────────────────┐
│ Tier 1: Flagship TLP │ PyPI/npm 공식 배포, 엔터프라이즈 프로덕션 안정성, 독립 PMC
└─────────────────────────┘
```
---
## 2. The 3-Tier Classification (3단계 분류 기준)
### Tier 3: Labs & Research (연구소 및 프로토타입)
- 정의: 혁신적인 아이디어를 탐색하고 기초 설계를 검증하는 실험적 단계.
- 특징:
- API 변경이 빈번할 수 있음.
- 별도의 엄격한 릴리즈 패키지 배포 의무 없음.
- 예시: Dead Internet Theatre, AMEVA-Agent-Orchestra, BitNet, AMEVA-Multi-CLI.
### Tier 2: Incubating Projects (인큐베이팅 프로젝트)
- 정의: 핵심 아키텍처가 확립되었으며, 안정화 및 재단 표준 준수 과정을 거치는 단계.
- 특징:
- 단일 연산 계약(Single-Source Op Contract) 및 엄격한 단위 테스트 커버리지 구축.
- Apache 2.0 또는 MIT 라이선스 헤더 표준화.
- 예시: AMV-Forge, AMV-Train, AMV-STT.
### Tier 1: Flagship Top-Level Projects (TLP / 대표 오픈소스)
- 정의: 글로벌 레지스트리(PyPI, npm)에 공식 배포되고 수많은 사용자에 의해 프로덕션 검증된 성숙한 프로젝트.
- 특징:
- 다중 런타임(Python + Node.js) 듀얼 패키징 완비.
- 전용 공식 문서 포털(GitHub Pages) 및 설치 스크립트 제공.
- 활성화된 커미터 풀 및 독립 PMC 운영.
- 예시: amv-playwright, amv-diffusion.
---
## 3. Graduation Criteria & Checklist (승격 심사 기준표)
### Checkpoint A: Tier 3 -> Tier 2 (인큐베이팅 진입 기준)
- [x] 명확한 기술 사명 및 엣지-퍼스트(Edge-First) 아키텍처 부합성
- [x] 기본 동작 검증 가능한 PoC 코드 및 최소 1개 이상의 동작 데모
- [x] 재단 표준 라이선스(Apache 2.0 / MIT) 채택
- [x] 멘토(기존 PMC 멤버) 1인 이상의 후원 및 추천
### Checkpoint B: Tier 2 -> Tier 1 (플래그십 TLP 승격 기준)
- [x] 공식 패키지 배포: PyPI 및 npm에 정식 네임스페이스로 배포 완료
- [x] 테스트 신뢰성: CI/CD 파이프라인 상에서 단위/E2E 테스트 100% PASS
- [x] 문서화 표준: 공식 웹사이트, API 레퍼런스, 벤치마크 리포트 구비
- [x] 커뮤니티 검증: 실사용자 피드백 수렴 및 이슈 대응 체계 가동
- [x] PMC 2/3 찬성 투표: 72시간 릴리즈/승격 투표 통과
---
## 4. Project Retirement & Archival (프로젝트 은퇴 및 아카이빙)
기술 트렌드의 변화나 상위 프로젝트로의 통합으로 유지보수가 중단된 프로젝트는 재단 이사회 승인을 거쳐 "Attic (은퇴/아카이브)" 상태로 안전하게 보존되며, 소스 코드는 영구 공개 상태를 유지합니다.
---
AMEVA Open-Source Foundation (AOSF)
Structured Incubation for Sustainable Open Source.
========================================================================
## SPONSORSHIP (source: foundation/SPONSORSHIP.md)
========================================================================
# 💖 Sponsor @uno-km & AMEVA On-Device Open-Source Project