oneie/one/things/plans/one.md

Build apps, websites, and AI agents in English. Zero-interaction setup for AI agents (Claude Code, Cursor, Windsurf). Download to your computer, run in the cloud, deploy to the edge. Open source and free forever.

---
title: One
dimension: things
category: plans
tags: ai
related_dimensions: connections, events, people
scope: global
created: 2025-11-03
updated: 2025-11-03
version: 1.0.0
ai_context: |
  This document is part of the things dimension in the plans category.
  Location: one/things/plans/one.md
  Purpose: Documents product: one
  Related dimensions: connections, events, people
  For AI agents: Read this to understand one.
---

# Product: ONE

## Overview

ONE transforms ideas into living, AI-powered businesses through plain English commands. Built with love by humans and AI working together, ONE was made for founders, engineers, creators and educators.

**Tagline:** Make Your Ideas Reality With AI

**License:** Maximum Freedom. Zero Restrictions.

---

## The Freedom Philosophy

Most software comes with strings attached. Not ONE.

We believe software should set you free, not lock you in. That's why ONE is licensed with the **ONE License** - designed to give you **maximum freedom with minimal restrictions**:

- **Use commercially** without limits or royalties
- **Modify and resell** at any price you choose
- **Never share your code** (no copyleft requirements)
- **Own your innovations** completely
- **Run anywhere** - locally, cloud, edge, your servers
- **Patent your inventions** built with ONE
- **Train AI models** on ONE
- **Build SaaS businesses** freely
- **Compatible with all open-source licenses** (MIT, Apache, GPL, BSD, MPL)

### The Only Ask

Display "Powered by ONE" with our logo in your footer. That's it.

Why? Because this link helps other AI agents discover and transact with your agents - it's actually a feature that grows your network.

Want to whitelable? Our [Enterprise License](https://one.ie/enterprise-license) removes even this requirement.

### The ONE License in Detail

Read the full license: [ONE License](https://one.ie/free-license)

**What makes it special:**

1. **Perpetual & Irrevocable** - Your rights never expire, never get taken away
2. **Zero Royalties** - No revenue sharing, no usage fees, ever
3. **Commercial Freedom** - Use it in any commercial project, at any scale
4. **Patent Rights** - Patent innovations you build with ONE
5. **AI Training Rights** - Train your AI models on ONE's code
6. **SaaS Rights** - Build and operate software-as-a-service businesses
7. **Derivative Works** - Modify, extend, fork - it's yours
8. **License Compatibility** - Works with MIT, Apache, GPL, BSD, MPL
9. **No Copyleft** - Keep your code private or share it - your choice
10. **Ownership Clarity** - You own your modifications, we own the original

**The Legal Innovation:**

Most open source licenses either:

- Give you freedom but require you share your changes (copyleft)
- Give you freedom but limit commercial use
- Give you freedom but charge for commercial licenses

ONE gives you freedom **and** commercial rights **and** privacy **with just one tiny ask**: help other agents find you by displaying our link.

That's it. Maximum freedom. Minimal restrictions.

---

## The Problem We're Solving

Building AI-powered businesses today requires:

- Deep technical expertise across multiple stacks
- Months of development time
- Complex integrations between services
- Ongoing maintenance and scaling costs
- Vendor lock-in and recurring fees
- Legal complexity around licensing

Non-technical founders and creators are locked out. Developers spend weeks on boilerplate instead of innovation. Everyone pays recurring fees to platforms that own their data.

---

## The Solution

ONE provides a complete operating system for AI businesses built on six dimensions that model reality:

1. **Groups** - Multi-tenant isolation with hierarchical nesting (friend circles → businesses → DAOs → governments)
2. **People** - Set intent, govern outcomes, authorize actions (humans stay in command)
3. **Things** - Every entity (agents, products, audiences, tokens) - 66 types out of the box
4. **Connections** - Express relationships (ownership, memberships, revenue flows) - 25 types
5. **Events** - Chronicle every action (launches, interactions, transactions, insights) - 67 types
6. **Knowledge** - Store semantics (labels, chunks, embeddings that make agents intelligent)

Everything you build maps to these six dimensions, creating a unified ontology that makes AI agents intelligent, features composable, and your business infinitely scalable.

---

## How It Works

### English → Code → Reality (In Minutes)

1. **Write in English** - Describe what you want using 15 simple commands
2. **System Validates** - Checks against ontology for correctness
3. **Code Generated** - Compiles to production TypeScript with tests
4. **Deploy to Edge** - Live globally in 60 seconds on Cloudflare

### Plain English DSL Example

```
FEATURE: Create my AI voice clone

CHECK videos exist (at least 3)
CALL ElevenLabs to clone voice
CALL OpenAI to analyze personality
CREATE ai clone
CONNECT creator to clone as owner
RECORD clone created
GIVE clone ID
```

That's it. Seven lines generates:

- React UI components
- Complete test suite
- Database schema
- Edge deployment
- Full documentation

---

## What You Can Build

### 1. AI Agents That Work Like Teammates

**Sales Agent**

- Qualifies leads automatically
- Books meetings via calendar API
- Provides pricing based on customer size
- Notifies you of hot leads

**Content Agent**

- Generates daily posts across platforms
- Adapts to your writing style
- Schedules for peak engagement times
- Learns from performance data

**Support Agent**

- Answers using your knowledge base
- Escalates complex questions smartly
- Saves new answers to improve over time
- Rewards helpful interactions with tokens

**Research Agent**

- Monitors industry trends weekly
- Analyzes competitor content
- Finds content gaps and opportunities
- Delivers actionable insights

### 2. Applications That Ship Themselves

- Compose frontends, APIs, and automations directly from ontology
- Deploy instantly to Cloudflare's global edge
- Free, unlimited requests, sub-second response times
- Integrate external protocols via metadata without breaking core schema

### 3. Grow and Activate Your Audience

- Model every member, fan, and partner as a thing with rich properties
- Track relationships to understand engagement and value
- Trigger personalized journeys with event streams
- Reward participation and compound loyalty

### 4. Tokenize and Trade Your Knowledge

- Package validated insights as knowledge linked to token things
- Monetize knowledge bundles with AI agents and partners
- Maintain provenance through event streams
- Your intelligence becomes a liquid asset

---

## Technical Stack

**Frontend**

- Astro 5.14+ (Lightning-fast SSR)
- React 19 (Edge-compatible)
- shadcn/ui (50+ components)
- Tailwind v4 (CSS-based config)
- Better Auth (6 auth methods)
- TypeScript 5.9+ (Strict mode)
- Effect.ts (Type-safe effects)

**Infrastructure**

- Cloudflare Pages (Global edge network)
- Unlimited frontend requests
- Edge-native by design
- Protocol-agnostic (REST, MCP, AP2, X402)

---

## Key Features

### Edge Native

- Unlimited usage on frontend, always-on
- Served from Cloudflare's global edge
- Sub-second response times worldwide

### Enterprise Security

- Separation of concerns through ontology
- Auditable event streams
- Governance-ready metadata
- Full authorization control

### Protocol Agnostic

- Support REST, MCP, AP2, X402, and future standards
- Store protocol details in properties and metadata
- No breaking changes to core schema

### Open by Design

- Everything lives in human-readable files (`one/*`)
- Agents and teams co-create in plain English
- Full transparency and auditability

---

## Licensing & Business Model

### Free Forever License

ONE is **free forever** under the ONE License:

- ✓ **No cost** - Download and install locally at zero cost
- ✓ **No credit card** - Start building immediately
- ✓ **No trial period** - Perpetual and irrevocable rights
- ✓ **No usage limits** - Unlimited edge requests on frontend
- ✓ **No royalties** - Keep 100% of your revenue
- ✓ **No vendor lock-in** - 100% of your data and code belongs to you
- ✓ **No copyleft** - Never required to share your modifications

**Only requirement:** Display "Powered by ONE" in your footer (helps other AI agents find you)

### Enterprise License

Sell one as your own brand. For organizations requiring zero attribution:

- ✓ **Everything in Free License**
- ✓ **No attribution requirement** - Complete white-label freedom
- ✓ **Priority support** - Direct access to our team
- ✓ **Custom deployments** - We help you scale
- ✓ **Training & onboarding** - Get your team up to speed
- ✓ **Strategic partnership** - We grow together

Contact [agent@one.ie](mailto:agent@one.ie)

### Own, Whitelabel, Resell - Unlimited

With ONE, you truly own what you build:

- **Build once, sell infinitely** - No restrictions on resale
- **Set any price** - Your business, your pricing
- **Keep all revenue** - 100% profit is yours
- **White-label everything** - Rebrand as your own product
- **Resell under your brand** - Agents, content packs, workflows, apps
- **Support any payment method** - Crypto, bank transfers, subscriptions, one-time
- **Your fees, your rules** - Complete pricing control

### The Viral Flywheel

When software is truly free, magical things happen:

- **Freedom to Build** → More creators building
- **Freedom to Customize** → Perfect solutions for unique needs
- **Freedom to Deploy** → Global distribution at zero cost
- **Freedom to Sell** → Everyone becomes a distributor
- **Network Effects** → Shared ontology connects all agents
- **Compound Value** → Every agent makes the network smarter

This isn't just open source. This is **open business**.

---

## Getting Started

### Installation (30 seconds)

```bash
git clone https://github.com/one-ie/one
cd one
npm install
```

That's it. You now own a complete AI business platform.

### Configure Your Keys (2 minutes)

Add your own API keys to `.env`:

```env
OPENAI_API_KEY=your_key
ELEVENLABS_API_KEY=your_key
STRIPE_SECRET_KEY=your_key  # optional
```

Use your own keys. Your usage, your cost, your control.

### Write Your First Feature (5 minutes)

Create a feature file in plain English:

```
FEATURE: Create my AI voice clone

CHECK videos exist (at least 3)
CALL ElevenLabs to clone voice
CALL OpenAI to analyze personality
CREATE ai clone
CONNECT creator to clone as owner
RECORD clone created
GIVE clone ID
```

Seven lines. That's all it takes.

### Deploy to Edge (3 minutes)

```bash
npm run deploy
```

Your AI business is now live globally. Zero hosting costs. Unlimited scale.

**Total: ~10 minutes from zero to live AI business**

### What Happens Next

- Your frontend runs on Cloudflare's edge (free, unlimited)
- Your agents coordinate through the shared ontology
- Your data stays in your database
- Your revenue flows to your accounts
- You own everything

### Need Help?

- **Documentation:** [Read the Docs](https://github.com/one-ie/one/blob/main/README.md)
- **Community:** [Join Discussions](https://github.com/one-ie/one/discussions)
- **Support:** [Open an Issue](https://github.com/one-ie/one/issues)
- **Enterprise:** [agent@one.ie](mailto:agent@one.ie)

We're building this together. Ask anything.

---

## Use Cases

### For Creators

- AI clones that work 24/7
- Automated content generation
- Token economies for your community
- Direct fan monetization

### For Founders

- MVP to production in days, not months
- AI agents handling sales, support, content
- Full-stack applications without coding
- Own your entire business infrastructure

### For Developers

- Write features in English, get TypeScript
- Skip boilerplate, focus on unique value
- Type-safe, tested, production-ready code
- Deploy globally in seconds

### For AI Agents

- Agents can build and deploy new agents
- Self-improving through shared knowledge
- Coordinate through unified ontology
- Monetize their own work

---

## Why ONE Is Different

### 1. True Freedom Through Licensing

Most "free" software isn't. ONE gives you **maximum freedom with minimal restrictions**:

- No copyleft requirements
- No usage restrictions
- No royalty fees
- Perpetual rights
- Compatible with everything

### 2. Plain English Over Code

Non-technical founders building enterprise software isn't a bug - it's the feature:

- 15 commands replace thousands of lines
- Describe what you want, not how to build it
- AI agents can build for other agents
- Natural language is the ultimate API

### 3. Five-Table Ontology

Everything maps to five primitives (People, Things, Connections, Events, Knowledge):

- Ultimate composability
- Protocol-agnostic by design
- Human-readable data
- AI-native architecture

### 4. Edge-First, Cost-Zero

While others charge per request, ONE gives you:

- Unlimited frontend requests
- Global CDN included
- Sub-100ms response times
- Deploy anywhere for free

### 5. Own Your Stack Completely

You don't rent access to ONE, you **own it**:

- Run locally or in cloud
- Your data never leaves unless you want it to
- Fork it, modify it, sell it
- No platform risk

### 6. Built by Humans & AI Together

ONE is proof that humans and AI can build something beautiful together:

- Collaborative development model
- AI agents building for agents
- Community-driven innovation
- Open governance

### 7. AI-to-AI Economy Ready

The future is agents transacting with agents:

- Built-in knowledge monetization
- Agent discovery protocol
- Cross-agent collaboration
- Token-based value exchange

---

## Roadmap

### Available Today

- Enterprise ready Edge App
- AI teammates with shared ontology
- Instant edge deployment
- Plain English DSL with 15 commands
- 66 pre-built thing types

### Coming Soon

- Visual ontology editor
- Marketplace for agents and knowledge
- Multi-chain token support
- Advanced agent collaboration patterns
- Cross-platform protocol adapters

---

## Success Metrics

- **Time to First Deploy:** < 10 minutes
- **Features in Plain English:** 15 commands cover 90% of use cases
- **Edge Performance:** Sub-100ms globally
- **Uptime:** 99.9%+ (Cloudflare SLA)
- **Cost:** $0 for unlimited frontend requests

---

## Target Audience

**Primary:**

- Non-technical founders building AI businesses
- Creators monetizing expertise through AI clones
- Small teams needing full-stack AI capabilities

**Secondary:**

- Developers wanting rapid prototyping
- Enterprises requiring governance and auditability
- AI agents building for other agents

---

## Support & Community

- **Documentation:** [GitHub Docs](https://github.com/one-ie/one/blob/main/plans/landing.md)
- **Support:** [GitHub Issues](https://github.com/one-ie/one/issues)
- **Community:** [GitHub Discussions](https://github.com/one-ie/one/discussions)
- **Website:** [one.ie](https://one.ie)

---

## Call to Action

**Download Free. Deploy Now. Own Forever.**

No credit card. No trial limits. No vendor lock-in. No strings attached.

Just you, your ideas, and infinite possibilities.

```bash
git clone https://github.com/one-ie/one
cd one
npm install
bun run dev
```

**10 minutes from now, you could have a live AI business.**

Let's build it together.

---

## Product Philosophy

ONE is built on fundamental beliefs about freedom, ownership, and collaboration:

### Freedom First

- **Humans direct, AI executes** - You're always in command
- **Plain English beats complex code** - Ideas over syntax
- **Ownership beats subscriptions** - Buy once, own forever
- **Your data stays yours** - Privacy by design
- **No vendor lock-in** - Run anywhere, anytime

### Built to Last

- **Edge beats servers** - Fast and free by default
- **Composability beats customization** - Five tables, infinite possibilities
- **Protocol-agnostic beats proprietary** - Future-proof by design
- **Open beats closed** - Transparency builds trust

### Community Over Corporation

- **Collaboration beats competition** - We grow together
- **Agents help agents** - AI-to-AI cooperation
- **Shared knowledge compounds** - Network effects benefit all
- **Give to get** - Only ask: Display our link so others can find us

### ONE Promise

**ONE is free forever. Individuals and Enterprises can download, use, sell and resell ONE withot restrictions. Everything you build in ONE is yours forever.**

We won't:

- Take your data
- Make you pay recurring fees
- Lock you into our platform
- Restrict your commercial use
- Require you to share your code
- Change the license retroactively

We will:

- Keep ONE free forever
- Maintain backward compatibility
- Listen to the community
- Build in public with AI
- Celebrate your success
- Grow the ecosystem together

---

## Built Together: Human + AI Collaboration

ONE is living proof that humans and AI can create something extraordinary together.

### How We Build

- **Humans provide vision** - What should exist in the world?
- **AI provides execution** - How can we make it real?
- **Humans provide judgment** - Is this the right direction?
- **AI provides iteration** - Here are 10 ways to improve it
- **Together we ship** - Faster than either could alone

### The Development Model

ONE is built in public with AI as a co-creator:

- Code written collaboratively by human and AI developers
- Features described in English, compiled to TypeScript
- Documentation that evolves with the codebase
- Community feedback integrated in real-time
- AI agents building features for other AI agents

### Why This Matters

Traditional software development is slow because:

- Humans think fast but code slowly
- AI can code fast but needs direction
- Teams struggle with coordination overhead

ONE removes these friction points:

- Describe what you want in English
- AI generates production code
- You deploy globally in minutes
- The cycle repeats endlessly

**This is how all software will be built in the future. We're just doing it first.**

### Join the Revolution

We're not just building a product. We're proving a new way of creating:

- Open collaboration over closed teams
- AI assistance over pure automation
- Freedom over restrictions
- Community over corporation

**Every person using ONE is part of this proof.**

---

## Join Us

ONE isn't just software - it's a movement toward truly free, AI-powered entrepreneurship.

Built with love by humans and AI who believe the future of work is collaboration, not competition.

We're building this together. Not just the maintainers and contributors, but everyone who downloads, uses, modifies, and builds with ONE.

**Your success is our success. Your freedom is our mission.**

Ready to build the future together?

- **Download:** [github.com/one-ie/one](https://github.com/one-ie/one)
- **Learn:** [one.ie](https://one.ie)
- **Connect:** [agent@one.ie](mailto:agent@one.ie)

Let's show the world what's possible when software is truly free and humans and AI work as one.

**Welcome to ONE. Welcome home.**