tmsteph/3dvr-portal

Open source personal computing with an AI Operator that does real work, with your approval.
3DVR Portal is a personal computing platform you can actually own: an AI Operator, practical business tools, and community apps, all in one open source codebase (GPLv3). No black boxes. The agent proposes, you approve, and every action leaves a receipt.
## Try it now
Live portal: https://portal.3dvr.tech
Meet Operator: https://portal.3dvr.tech/operator/
Join the open build: https://portal.3dvr.tech/operator/open/
No install needed to look around. Hosted personal agents are in pilot; builders can run the whole thing themselves.
## What you get
Operator, an AI agent with guardrails. It plans work, uses tools, and remembers context. Anything risky waits for your explicit approval, and approvals are bound to the exact action you saw. Models are pluggable: hosted APIs first, local models (Ollama) as a fallback, through one router.
Business tools that earn their keep. CRM, contacts, calendar, tasks, and notes, built for a small business that runs on them daily (ours).
Android Companion. An opt-in bridge for bounded phone control, with high-impact actions kept behind policy and approval boundaries.
Community and play. Open apps, experiments, and a game hub, because personal computing should be fun as well as useful.
## Run it locally
bash
git clone https://github.com/tmsteph/3dvr-portal.git
cd 3dvr-portal
npm install
npm run dev
Run the checks with npm test (portal), npm run test:agent (agent), npm run test:computing (computing), or npm run test:all for everything.
## Where the build is
Operator is the active focus. The safety core (policy, approvals, receipts) is merged, along with the model router and the planner. In progress now: persistent memory, a tool bridge (files, mail, calendar, browser), an approval UI, and speed work. The execution layer lives in apps/agent, the shared safety core in operator-core, and the Android control plane in apps/companion.
Good first contributions: docs, accessibility fixes, tests, and small tools. If you believe people should be able to understand, modify, and own the computing systems they depend on, welcome home.
## Contributing
3DVR is intentionally open source. Useful contributions include bug fixes, accessibility improvements, documentation, experiments, new open tools, and simplifying existing systems. Open an issue first for anything large so we can point you at the right part of the tree.
## License
GPLv3. See LICENSE.
## Project notes
### Canonical monorepo
tmsteph/3dvr-portal is the default home for active 3DVR product, platform, and research development.
New capability should normally extend this repository rather than create another 3DVR repository. Independent deployment, packaging, or release does not by itself require a separate repository. Shared code and cross-product contracts should stay together so the Agent, Portal, devices, tests, and experiments can evolve as one system.
Separate repositories remain useful when work must closely track an upstream project, has a genuinely independent contributor/release lifecycle, or is intentionally preserved as a reference or historical archive. Older 3DVR repositories should increasingly point back here when their active ideas have been absorbed.