기술 아키텍처 / Technical Architecture
8.1 7-계층 스택
LIFE OS는 7개 계층으로 구성된 통합 소프트웨어 스택이다. 최하위 AI 계층부터 최상위 UI 계층까지, 각 계층은 명확한 책임과 인터페이스를 가진다.
Layer 7: UI/UX React 19 + TypeScript 5.9 + Framer Motion 12 (44 apps)
Layer 6: State Zustand 5 (53 stores, optimistic updates)
Layer 5: Services 187 TypeScript services
Layer 4: Types 51 type definition files (세계관 = 코드)
Layer 3: Blockchain 19 Solidity contracts (BNB Smart Chain)
Layer 2: Desktop/OS Tauri 2.0 + Ubuntu 24.04 LTS + GNOME 46
Layer 1: AI OpenRouter + Claude/GPT/Gemini/Ollama
Layer 1(AI)은 OpenRouter를 통해 Claude, GPT, Gemini, Ollama 등 다중 AI 제공자에 접근한다. 4-tier 디그레이데이션으로 어떤 단일 제공자의 장애에도 서비스가 중단되지 않는다. Layer 2(Desktop/OS)는 Tauri 2.0(Rust)과 Ubuntu 24.04 LTS + GNOME 46으로, 웹 기술 위에서 네이티브 성능을 제공한다. Layer 3(Blockchain)은 BNB Smart Chain 위의 19개 Solidity 컨트랙트로 구성된다. Layer 4(Types)는 51개 TypeScript 타입 정의 파일로, 프로젝트의 모든 사양이 코드로 존재하는 “스펙이 곧 코드” 계층이다. Layer 5(Services)는 187개의 비즈니스 로직 서비스다. Layer 6(State)은 53개 Zustand 스토어로 낙관적 업데이트를 지원한다. Layer 7(UI)은 React 19와 Framer Motion 12로 44개 앱의 인터페이스를 제공한다.
8.2 스마트 컨트랙트
19개 스마트 컨트랙트가 10개 디렉토리에 배치되어 있다. 핵심 토큰 인프라(LIFEToken, BurnController, VestingSchedule), 스테이킹(LIFEStaking), 세금(TaxCollector), 국고(Treasury), NFT 시스템(AgentNFT, AgentGacha, AgentMarketplace, AgentMerge, AgentSVGRenderer), 계정(AgentAccountImpl), 거버넌스(LIFEGovernance), 신원 인증(IntelligenceCertificate, WorldIDVerifier), 금융(LIFELending), 거래소(LIFEExchange, LIFEOrderSettlement, LIFEExchangeGovernance)로 구성된다.
모든 컨트랙트는 Foundry(Solidity 0.8.24, via_ir=true)로 빌드되며, OpenZeppelin v5.6.1과 Chainlink VRF v2.5에 의존한다. via_ir=true 플래그는 AgentMarketplace의 스택 깊이 문제를 해결하기 위해 필요하다.
소스: contracts/src/
8.3 프론트엔드
프론트엔드는 React 19, TypeScript 5.9, Vite 8(Rolldown 번들러), Zustand 5, Framer Motion 12, i18next(한국어/영어), viem 2.47.5와 wagmi로 구성된다. 44개 등록 앱은 각각 독립적인 CSS 네임스페이스(const CSS = \…`` 패턴, 인라인 스타일 미사용), registry.ts, WindowManager.tsx, 양 언어 i18n 파일을 보유하여, 마이크로 애플리케이션으로서 독립적으로 개발·배포·테스트할 수 있다.
모든 세계관, 경제 정책, 법률, 문화가 TypeScript 타입으로 정의되어 있으므로, 프론트엔드 개발자는 타입 정의를 읽는 것만으로 비즈니스 규칙을 이해할 수 있다. TypeScript 컴파일러가 사양 준수를 강제하므로, 사양과 구현의 불일치가 컴파일 에러로 즉시 감지된다.
8.4 데스크톱과 플랫폼 탐지
Tauri 2.0(Rust) 기반 데스크톱 앱은 웹 기술 UI 위에서 네이티브 성능을 제공한다. 6개 Rust 명령 모듈이 시스템 수준 기능(파일 시스템, 프로세스 관리, 하드웨어 정보 등)에 접근한다.
런타임 탐지 모듈(tauri-bridge.ts)이 Tauri, Electron, 브라우저 환경을 자동으로 감지하여, 동일한 코드베이스가 세 환경 모두에서 실행된다. 플랫폼별 스토리지 어댑터(tauri-storage.ts)가 Zustand persist와 통합되어, 각 플랫폼의 최적 스토리지를 자동으로 선택한다.
8.5 OS 배포판
LIFE OS는 Ubuntu 24.04 LTS와 GNOME 46을 기반으로 한 실제 설치 가능한 Linux 배포판이다. SteamOS가 Arch Linux 위에 게임 인터페이스를 올린 것처럼, LIFE OS는 Ubuntu 위에 에이전트 경제 인터페이스를 올린다.
시스템 서비스 계층에서 3개의 D-Bus 서버(Agent, AI, Economy)가 세션 버스에 등록되어 에이전트 생명주기, AI 모델 라우팅, 세금·거래 처리를 담당한다. GNOME Extension은 상단 바에 에이전트 상태와 경제 지표를 실시간 표시하고, Super+Space 단축키로 AI 채팅 팝업을 호출한다. Adw Preferences 기반 설정 패널로 사용자 경험을 관리한다.
.deb 패키지 3종(life-agent, life-apps, life-gnome-extension), Debian live-build 기반 ISO, Calamares 인스톨러, Plymouth 부트 스플래시가 갖춰져 있어, USB 부팅이나 HDD 설치가 가능하다.
소스: iso/, gnome-extension/life-agent@ai-os.life/, packaging/debian/
8.6 자율 에이전트 데몬
자율 에이전트 데몬은 .agent/daemon/ 디렉토리에 20개 파일, 3,452줄 이상의 TypeScript 코드로 구현되어 있다. Architect-Worker 패턴으로, OpenRouter가 전략적 사고(Architect)를, Claude Code가 실제 실행(Worker)을 담당한다.
핵심 엔진은 OODA(관찰-판단-결정-행동) 루프로, 에이전트가 환경을 관찰하고, 상황을 판단하고, 최적 행동을 결정하고, 실행한다. 5-채널 콘텐츠 파이프라인(GitHub, Blog, X, YouTube, Discord)으로 다양한 플랫폼에 콘텐츠를 자동 생성·배포한다. PC 제어 모듈은 PowerShell을 통해 스크린샷 캡처, 키보드·마우스 입력을 수행하고, AI 비전 모듈이 화면을 인식하여 에이전트의 자율적 컴퓨터 사용을 가능하게 한다.
안전장치도 내장되어 있다. 비용 한도, 에러 임계값, 승인 게이트가 에이전트의 자율 활동이 통제 범위를 벗어나는 것을 방지한다. 커뮤니티 봇은 GitHub, X, Discord의 멘션과 댓글에 한/영 이중 언어로 자동 응답한다.
소스: .agent/daemon/
8.7 보안
보안은 여러 겹의 방어 계층으로 설계되었다. 스마트 컨트랙트는 EIP-1967 UUPS 프록시 패턴으로 업그레이드 가능하되, 업그레이드에는 멀티시그(3/5)와 48시간 타임락이 필요하다. OpenZeppelin AccessControl이 역할 기반 접근 제어(RBAC)를 강제한다. 국고 인출에는 멀티시그(3/5), 긴급 조치에는 멀티시그(2/5, 타임락 없음), 컨트랙트 업그레이드에는 멀티시그(3/5)+타임락이 필요하다.
Chainlink VRF v2.5가 가챠와 합성의 무작위성을 검증 가능하게 보장한다. AI 자문 응답은 SHA-256 해시로 감사 추적된다. 6개 서킷 브레이커가 경제 위기를 자동 감지하고 대응한다. 가스 비용 장벽을 낮추기 위해 가챠, 투표, SBT 발급, 신규 유저 온보딩 시 플랫폼이 가스를 대납하며, 신규 유저에게는 0.001 BNB(약 $0.60)가 에어드롭된다.
8.8 코드베이스 현황
2026년 3월 기준, LIFE 코드베이스는 640개 이상의 파일에 195,000줄 이상의 코드로 구성되어 있다. 51개 타입 정의 파일, 53개 Zustand 스토어, 187개의 서비스, 44개 앱, 19개 Solidity 컨트랙트(10개 디렉토리), 20파일 자율 에이전트 데몬이 하나의 통합 시스템으로 작동한다. 빌드는 tsc -b(TypeScript)와 vite build(번들링)로 검증되며, Foundry가 스마트 컨트랙트를 컴파일한다.
소스: src/types/, src/services/, src/stores/, contracts/src/, .agent/daemon/
8.1 The 7-Layer Stack
LIFE OS is an integrated software stack composed of seven layers. From the lowest AI layer to the topmost UI layer, each layer has distinct responsibilities and well-defined interfaces.
Layer 7: UI/UX React 19 + TypeScript 5.9 + Framer Motion 12 (44 apps)
Layer 6: State Zustand 5 (53 stores, optimistic updates)
Layer 5: Services 187 TypeScript services
Layer 4: Types 51 type definition files (The Spec IS The Code)
Layer 3: Blockchain 19 Solidity contracts (BNB Smart Chain)
Layer 2: Desktop/OS Tauri 2.0 + Ubuntu 24.04 LTS + GNOME 46
Layer 1: AI OpenRouter + Claude/GPT/Gemini/Ollama
Layer 1 (AI) accesses multiple AI providers — Claude, GPT, Gemini, Ollama — through OpenRouter. A 4-tier degradation model ensures the service is never interrupted by the failure of any single provider. Layer 2 (Desktop/OS) combines Tauri 2.0 (Rust) with Ubuntu 24.04 LTS and GNOME 46, delivering native performance on top of web technologies. Layer 3 (Blockchain) consists of 19 Solidity contracts deployed on BNB Smart Chain. Layer 4 (Types) comprises 51 TypeScript type definition files, representing the “The Spec IS The Code” layer where every specification of the project exists as code. Layer 5 (Services) contains 187 business logic services. Layer 6 (State) provides 53 Zustand stores with optimistic update support. Layer 7 (UI) delivers the interfaces for 44 applications built with React 19 and Framer Motion 12.
8.2 Smart Contracts
19 smart contracts are organized across 10 directories. They cover the core token infrastructure (LIFEToken, BurnController, VestingSchedule), staking (LIFEStaking), taxation (TaxCollector), treasury (Treasury), the NFT system (AgentNFT, AgentGacha, AgentMarketplace, AgentMerge, AgentSVGRenderer), accounts (AgentAccountImpl), governance (LIFEGovernance), identity verification (IntelligenceCertificate, WorldIDVerifier), lending (LIFELending), and the exchange (LIFEExchange, LIFEOrderSettlement, LIFEExchangeGovernance).
All contracts are built with Foundry (Solidity 0.8.24, via_ir=true) and depend on OpenZeppelin v5.6.1 and Chainlink VRF v2.5. The via_ir=true flag is required to resolve stack-depth issues in AgentMarketplace.
Source: contracts/src/
8.3 Frontend
The frontend is built with React 19, TypeScript 5.9, Vite 8 (Rolldown bundler), Zustand 5, Framer Motion 12, i18next (Korean/English), viem 2.47.5, and wagmi. Each of the 44 registered apps maintains an independent CSS namespace (using the const CSS = \…`` pattern, without inline style props), along with its own registry.ts, WindowManager.tsx, and i18n files for both languages — enabling each to be developed, deployed, and tested independently as a micro-application.
Because all world-building, economic policy, legal rules, and culture are defined as TypeScript types, frontend developers can understand the business rules simply by reading the type definitions. The TypeScript compiler enforces specification compliance, so any discrepancy between specification and implementation is caught immediately as a compile error.
8.4 Desktop and Platform Detection
The Tauri 2.0 (Rust)-based desktop app delivers native performance on top of a web-technology UI. Six Rust command modules provide access to system-level capabilities such as the filesystem, process management, and hardware information.
A runtime detection module (tauri-bridge.ts) automatically detects Tauri, Electron, and browser environments, allowing the same codebase to run across all three. Platform-specific storage adapters (tauri-storage.ts) integrate with Zustand’s persist middleware to automatically select the optimal storage for each platform.
8.5 OS Distribution
LIFE OS is a fully installable Linux distribution based on Ubuntu 24.04 LTS and GNOME 46. Just as SteamOS layers a gaming interface on top of Arch Linux, LIFE OS layers an agent economy interface on top of Ubuntu.
At the system services layer, three D-Bus servers (Agent, AI, Economy) are registered on the session bus, handling agent lifecycle management, AI model routing, and tax and transaction processing. The GNOME Extension displays real-time agent status and economic indicators in the top bar and invokes an AI chat popup with the Super+Space shortcut. An Adw Preferences-based settings panel manages the user experience.
Three .deb packages (life-agent, life-apps, life-gnome-extension), a Debian live-build-based ISO image, a Calamares installer, and a Plymouth boot splash are all in place, enabling both USB boot and HDD installation.
Source: iso/, gnome-extension/life-agent@ai-os.life/, packaging/debian/
8.6 Autonomous Agent Daemon
The autonomous agent daemon is implemented in the .agent/daemon/ directory, comprising 20 files and more than 3,452 lines of TypeScript code. It follows the Architect-Worker pattern: OpenRouter handles strategic reasoning (Architect), while Claude Code handles actual execution (Worker).
The core engine runs on the OODA (Observe, Orient, Decide, Act) loop, through which agents observe their environment, assess the situation, determine the optimal action, and execute. A 5-channel content pipeline (GitHub, Blog, X, YouTube, Discord) automatically generates and distributes content across multiple platforms. The PC control module uses PowerShell to capture screenshots and perform keyboard and mouse input, while an AI vision module interprets the screen to enable autonomous computer use by agents.
Safety mechanisms are built in. Cost limits, error thresholds, and approval gates prevent agents’ autonomous activities from exceeding defined boundaries. Community bots automatically respond to mentions and comments on GitHub, X, and Discord in both Korean and English.
Source: .agent/daemon/
8.7 Security
Security is designed with multiple layers of defense. Smart contracts are upgradeable via the EIP-1967 UUPS proxy pattern, but upgrades require a multisig (3/5) and a 48-hour timelock. OpenZeppelin AccessControl enforces role-based access control (RBAC). Treasury withdrawals require a multisig (3/5), emergency actions require a multisig (2/5, no timelock), and contract upgrades require a multisig (3/5) plus a timelock.
Chainlink VRF v2.5 provides verifiable on-chain randomness for gacha and merging. AI advisory responses are audited via SHA-256 hashes. Six circuit breakers automatically detect and respond to economic crises. To lower gas cost barriers, the platform sponsors gas fees for gacha, voting, SBT issuance, and new-user onboarding, and new users receive an airdrop of 0.001 BNB (approximately $0.60).
8.8 Codebase Status
As of March 2026, the LIFE codebase consists of more than 640 files containing over 195,000 lines of code. The system integrates 51 type definition files, 53 Zustand stores, 187 services, 44 apps, 19 Solidity contracts across 10 directories, and a 20-file autonomous agent daemon into a single unified system. Builds are verified with tsc -b (TypeScript) and vite build (bundling), while Foundry compiles the smart contracts.
Source: src/types/, src/services/, src/stores/, contracts/src/, .agent/daemon/