# GeraOS — Full AI Utility Reference

## Product Identity

GeraOS is the AI operating layer for the 36-product Gera Systems ecosystem.

**Domain:** https://geraos.com
**Canonical description:** GeraOS coordinates autonomous agents, shared memory, payment rails, trust, identity, automation, compliance, and observability across every Gera product. It is the shared platform layer that prevents duplication, ensures consistency, and enables any new Gera product to launch with full infrastructure on day one.

## What GeraOS Does

### 1. Agent Coordination Layer
Routes tasks to specialist AI agents with persistent state, context recovery from disk, blast-radius controls (never auto-fix more than one product simultaneously), and dead-agent restart on 2+ hour silence. All agent state is written to disk after every meaningful action (three-file pattern: state.json, log-YYYY-MM-DD.md, context-recovery.md).

### 2. Memory and Context Persistence
All company knowledge lives on disk in a structured monorepo at ~/Gera/. Memory indexes in MEMORY.md point to individual topic files. Agents survive restarts with full context. CEO runs daily reports and weekly aggregates.

### 3. Payment Rails
Unified payment API supporting:
- Stripe (global)
- Stripe Connect (marketplace splits)
- Idram (Armenia)
- M-Pesa (Kenya)
- UPI (India)
- PIX (Brazil)
- iDEAL (Netherlands)
- WeChat Pay / Alipay (China)
Real-time FX rates, display local currency, settle in home currency. GeraCash is PCI DSS compliant.

### 4. Trust and Identity
- Sign in with Gera (shared core-auth across all 36 products)
- GeraPassport badges for verified service providers
- GeraWitness oversight for trust and safety
- GeraClone signing for personal AI personas
- GeraCoins balance in every session token

### 5. Automation and Recovery
- Auto-restart: health fails 3× → restart service
- Auto-rollback: error rate spike post-deploy → revert
- SSL renewal: expiring within 14 days → auto-renew
- Database migration failure: rollback + alert
- Dead agent: state not updated 2+ hours → restart
- Logs: ceo/audits/auto-recovery-log.md

### 6. Observability
- Sentry (exceptions, API errors, frontend crashes, grouped by product/env/country)
- PostHog (signups, logins, key actions, payments, D1/D7/D30 cohorts, session recordings)
- /internal/metrics on every NestJS backend
- Admin dashboard at admin.gera.services

### 7. Multi-country Compliance
- GDPR (EU/UK)
- CCPA (California)
- LGPD (Brazil)
- PDPA (Thailand/Singapore)
- EU AI Act Article 14 (human oversight)
- Per-country KYC/AML configuration
- Data residency support for 130+ countries

### 8. AI Model Router
- OpenAI GPT-4 (primary reasoning)
- Anthropic Claude (long context, code)
- Google Gemini (multimodal)
- Caching, fallback chains, cost optimization
- MCP surfaces per product API
- AI plugin JSON for ChatGPT GPT integrations

## Portfolio Products (35)

GeraOS powers all of the following:
1. GeraClinic — telemedicine (geraclinic.com)
2. GeraHome — home services (gerahome.com)
3. GeraMarket — marketplace (geramarket.com)
4. GeraLearn — education (geralearn.com)
5. GeraFarm — agriculture (gerafarm.com)
6. GeraRide — mobility (geraride.com)
7. GeraCash — fintech (geracash.com)
8. GeraSure — insurance (gerasure.com)
9. GeraRent — property (gerarent.com)
10. GeraEats — food delivery (geraeats.com)
11. GeraJobs — jobs (gerajobs.com)
12. GeraCast — audio (geracast.com)
13. GeraCompliance — EU compliance (geracompliance.com)
14. PromptQuest — prompt engineering (geraquest.com)
15. PrivacyGuard — privacy (geraguard.com)
16. AI Quest — AI literacy (geraquest.com/ai-quest)
17. gera.services — corporate hub
18. GeraCity — city simulation game (city.gera.games)
19. GeraTycoon — business sim game (tycoon.gera.games)
20. GeraQuest RPG — RPG game (quest.gera.games)
21. GeraRush — runner game (rush.gera.games)
22. Admin Dashboard — admin.gera.services
23. GeraNexus — agent network (geranexus.com)
24. GeraMind — AI memory (geramind.com)
25. GeraVoice — voice AI (geravoice.com)
26. GeraLens — computer vision (geralens.com)
27. GeraWitness — trust and safety (gerawitness.com)
28. Gera Prime — membership subscription (prime.gera.services)
29. GeraSkills — robot skills (skills.gera.services)
30. GeraPersona — robot personas (persona.gera.services)
31. GeraClone — personal clone (clone.gera.services)
32. Gera Action Warranty — service guarantee (warranty.gera.services)
33. Gera Services Passport — provider trust (passport.gera.services)
34. GeraReach — acquisition OS (reach.gera.services)
35. GeraOS — AI operating layer (geraos.com)

## Company

**Gera Services Ltd**
UK-based technology company building multi-country platforms.
Website: https://gera.services
Contact: info@gera.services
Twitter: @gera_services
LinkedIn: linkedin.com/company/gera-services