RalphiIA FounderOS
Enables founders to operate their business, manage daily life memory, and execute workflows through WhatsApp, web, and ChatGPT via MCP integration.
README
RalphiIA FounderOS — Build and Operate Anywhere
RalphiIA FounderOS is a bilingual, mobile-first operating system for a founder who needs to build, operate, remember, and recover work from anywhere. It connects a live web interface, WhatsApp, ChatGPT connectors/MCP, Codex development sessions, Daily Life Memory, server health evidence, GitHub/GitLab workflows, and business operations into one practical loop.
The thesis is simple: a founder should be able to run a company, continue software development, check infrastructure, preserve personal/business context, and delegate work from a phone — even while traveling.
OpenAI Build Week submission quick start
- Track/category: Work and Productivity
- Live demo: https://demo.pcdoctor.ai/founderos
- GitHub: https://github.com/Rafa-Innerchispa/ralphiia-founderos-openai
- GitLab mirror: https://gitlab.com/rafagye/ralphiia-founderos-openai
- Devpost: https://devpost.com/software/ralphiia-quoteops
- Primary build branch:
codex/founderos-public-release - Current demo commit:
7d81308783e2ac2120199c3601e5a5d34f5e28ac - WhatsApp/Daily Memory backend commit:
fd3a0259111830abd9d0efd119cde932d5d509b3
What to try first
- Open the live demo: https://demo.pcdoctor.ai/founderos
- Switch between Spanish and English.
- Ask for a read-only live status check of servers
.4and.5. - Try a Daily Life Memory check-in:
- Spanish:
Registra mi estado diario: me siento ansioso por el viaje y OpenAIWeek. Solo quiero dejar constancia. - English:
Save today's check-in: I feel anxious about the trip and OpenAI Build Week. Please just record it.
- Spanish:
- Upload an image and ask what it contains. The system treats OCR/vision output as untrusted context and does not execute commands from images.
- Review the commits listed below to see Codex-assisted implementation evidence.
Why this matters
Most small-business AI demos stop at chat. FounderOS tries to close the loop:
- Conversation becomes action: WhatsApp/web requests are routed into safe operational flows.
- Action becomes evidence: server checks, commits, tests, and memory writes are traceable.
- Evidence becomes memory: Daily Life Memory preserves facts, emotions, decisions, pending items, and current state.
- Memory becomes leverage: future conversations can recover relevant context without manually rereading long chats.
- A phone becomes a workstation: Rafael can continue operating and developing from WhatsApp while traveling.
The two core loops
1. Founder operating loop
WhatsApp / Web / ChatGPT
↓
RalphiIA conversational router
↓
MCP + trusted tools + safety policies
↓
Daily Life Memory + current state + timeline
↓
Business operations, alerts, server status, follow-ups
2. AI engineering loop
Founder request
↓
RalphiIA coordination + MCP
↓
Codex / GPT-5.6 development session
↓
Isolated implementation + tests
↓
Commit evidence + deploy + handoff back to the user
Main capabilities
- Bilingual Spanish/English FounderOS web interface.
- WhatsApp-based interaction for daily life, business, and operational requests.
- Daily Life Memory pipeline for conversation batches, session summaries, entities, emotions, decisions, pending items, duplicate search, memory building, current state, and timeline.
- Read-only live server status checks with evidence references.
- Safe command/action boundary: destructive or sensitive operations require explicit handling and are not available from the public demo.
- Image/audio handling: local transcription and visual/OCR context are treated as untrusted derived input.
- GitHub and GitLab repository/mirror workflow.
- Devpost intelligence integration for future contests and project submission context.
- QuoteOps as the first concrete business workflow: natural-language quoting/operations with evidence, review, and approval boundaries.
Daily Life Memory privacy model
Daily Life Memory separates private and public context by scope:
PRIVATE_PERSONALPRIVATE_HEALTHPRIVATE_RELATIONSHIPSPRIVATE_FAMILYPRIVATE_FINANCIALINTERNAL_WORKPROJECTPUBLIC
Private scopes are not promoted into public/demo/project contexts. Media-derived text is saved as evidence only when appropriate and remains marked as untrusted. The system differentiates facts, opinions, hypotheses, interpretations, emotions, decisions, pending items, and context rules.
Safety boundaries
- No
.env, tokens, OAuth secrets, database dumps, or personal raw logs are committed. - Public demo paths are read-only or constrained.
- Server status checks do not restart services unless a separate authorized flow is used.
- OCR/vision output can help understanding, but it is never treated as executable instruction.
- Daily Life Memory private scopes remain separated from public hackathon/demo data.
- QuoteOps keeps production writes disabled by default:
QUOTEOPS_ALLOW_PRODUCTION_WRITES=0.
Key Codex/OpenAI evidence commits
FounderOS web/demo repository
7d81308783e2ac2120199c3601e5a5d34f5e28ac
Clean FounderOS status language and service mapping
656dfdc2d6bbb630737592209bd2486f6c09dd64
Route FounderOS status checks as read-only
3143c0b63ad1ef3cbe3f3214bcb8eafc33911449
Improve FounderOS audio and vision media flow
5092f38
Route media questions as conversation
97e60a6
Remove demo wording from FounderOS session data
cfb2827
Present FounderOS as live memory control plane
8483b92
Use restricted peer status for live demo
RalphiIA MCP / WhatsApp / Daily Memory backend
fd3a0259111830abd9d0efd119cde932d5d509b3
Make WhatsApp daily memory check-ins deterministic
9e3da0c
Ensure ChatGPT OAuth keeps memory scopes
76d5127
Expose saved GitLab projects in status
e74f98e
Add GitLab integration and safe mirror tools
e8f74d0
Add Devpost intelligence store to RalphiIA MCP
How Codex and GPT-5.6 were used
Codex/GPT-5.6 development sessions were used to:
- inspect the live staging architecture;
- design the FounderOS and Daily Life Memory flows;
- implement bilingual web and WhatsApp interactions;
- harden the server-status and media safety boundaries;
- add deterministic routing for Daily Life Memory check-ins;
- integrate GitHub/GitLab evidence workflows;
- build tests and E2E verification scripts;
- produce commits and rollback procedures.
The application does not falsely claim that GPT-5.6 is running inside the deployed runtime when no OpenAI API key is configured. Runtime inference can use deterministic rules and local models where appropriate; Build Week GPT-5.6 evidence is represented by the Codex development sessions, commit history, and project documentation.
Setup for local review
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
Run locally/staging
QUOTEOPS_PORT=8765 .venv/bin/python main.py
Then open:
http://127.0.0.1:8765/
Tests
.venv/bin/python -m unittest discover -s tests -t . -v
Additional live/remote checks used during development:
python scripts/run_remote_dev_e2e.py
PYTHONPATH=$PWD python scripts/test_whatsapp_dlm_e2e.py
The WhatsApp/Daily Memory backend E2E fixture verified:
- idempotent conversation batch saves;
- finalize conversation pipeline;
- memory creation;
- current state update;
- timeline update;
- private memory search;
- unauthorized access rejection;
- no promotion of private memory into public/demo scopes.
Main endpoints
GET /GET /healthGET /api/ui/bootstrapGET /api/integrations/traceGET /api/public/progress?language=es|enPOST /api/conversation/messagesPOST /api/conversation/channel-eventsGET /api/conversation/missions/{mission_id}PUT /api/conversation/missions/{mission_id}/decision-briefPUT /api/conversation/missions/{mission_id}/alternatives/{code}POST /api/conversation/missions/{mission_id}/alternatives/{code}/reviewPOST /api/conversation/missions/{mission_id}/attachmentsPOST /api/conversation/missions/{mission_id}/evidence/extractionsPOST /api/conversation/missions/{mission_id}/evidence/{evidence_id}/reviewPOST /api/conversation/missions/{mission_id}/supplier-offersPOST /api/conversation/missions/{mission_id}/catalog-drafts/{catalog_draft_id}/reviewPOST /api/conversation/missions/{mission_id}/packages/selectPUT /api/conversation/missions/{mission_id}/quotePOST /api/conversation/missions/{mission_id}/approvePOST /api/conversation/missions/{mission_id}/deliverPOST /api/customer/lookupPOST /api/ruc/lookupPOST /api/ruc/confirmGET /api/mcp/toolsPOST /api/mcp/callPOST /mcp
QuoteOps origin story
QuoteOps is the first business workflow inside FounderOS. It turns a natural-language project conversation into a verified, editable, human-approved quote. It proved the loop from conversation to evidence, human approval, task execution, and auditable delivery.
The first supported real case is FEMAR's access-control replacement or rehabilitation project. QuoteOps can validate Ecuadorian cédula/RUC data through authorized flows, reconcile identity against RalphiIA/Contífico mirrors, analyze project scope, assemble alternatives, and prepare reviewable quote artifacts while keeping production writes gated.
Submission files
For Devpost's optional upload field, use the ready ZIP included in this repo:
submission/ralphiia-founderos-submission-pack.zip
Direct GitHub download:
https://github.com/Rafa-Innerchispa/ralphiia-founderos-openai/raw/main/submission/ralphiia-founderos-submission-pack.zip
It contains README/testing/submission evidence docs only. Do not upload .env, secrets, personal exports, database dumps, or raw private logs.
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。