# BuildAI — Complete Platform Reference (Extended)

This is the extended version of llms.txt for BuildAI at https://build-a-i.org

For the standard version, see: https://build-a-i.org/llms.txt

## Platform Architecture

BuildAI is a web-based SaaS platform. Users interact through:
1. A browser-based dashboard at build-a-i.org
2. The BuildAI Architect — a conversational AI that designs custom AIs
3. REST API endpoints for programmatic access to deployed AIs
4. A public preview system for testing AIs before purchase
5. An AI marketplace for buying/selling custom AIs

## How an AI Gets Created (Step by Step)

1. User signs up at build-a-i.org/auth (free account)
2. User navigates to build-a-i.org/create
3. User chats with the BuildAI Architect in plain English
4. The Architect asks 2-4 clarifying questions about purpose, personality, tools, and safety
5. The BuildAI Engine generates a complete AI specification (JSON)
6. The Engine creates a production system prompt, configures tools, sets memory mode
7. An AI model record is created with a unique API endpoint
8. An API key (bai_xxxxx) is generated for authentication
9. The AI is immediately live and callable via REST API
10. Optional: User lists the AI on the marketplace for sale

## Tool Execution Flow (Agentic Loop)

When a deployed AI receives a message that requires tools:

1. **Intent Classification** — The Engine determines if tools are needed
2. **Tool Selection** — Appropriate tools are selected (search, calculator, etc.)
3. **Execution** — Tools run in parallel where possible
4. **Result Processing** — Raw results are truncated/summarized if >2000 chars
5. **Chain-of-Verification** — URL and fact validation on search results
6. **Synthesis** — AI generates a final response incorporating tool results
7. **Response** — User receives the response with usage metrics

## Memory Architecture

### Short-term Memory
- Stored in conversation session context
- Last 10-20 messages retained per session
- Cleared when session ends

### Long-term Memory
- Stored in database per user-AI pair
- Key facts, preferences, and patterns extracted
- Persists across sessions indefinitely
- Importance scoring for retrieval priority

### Document Memory
- Users upload PDF, TXT, CSV files
- Files are processed: text extracted, summarized, key topics identified
- Summaries injected into AI system prompt context
- Enables domain-specific knowledge without fine-tuning

## Security Model

1. **Authentication** — All API calls require valid API key (bai_xxxxx format)
2. **Rate Limiting** — Configurable per-minute limits per AI
3. **Input Sanitization** — Prompt injection detection and filtering
4. **Content Filtering** — Configurable allowed/disallowed topic lists
5. **Identity Enforcement** — User authentication required for owner actions
6. **Key Encryption** — API keys stored encrypted, never exposed in logs
7. **Audit Logging** — All admin actions logged with timestamps

## Billing Model

### Builder Credits
- Used when chatting with the BuildAI Architect to create/edit AIs
- 1-10 credits per message depending on complexity
- Reset monthly based on subscription tier
- Do NOT apply to end-user API calls

### API Balance (USD)
- Used when end-users call deployed AIs via API
- Prepaid balance, starting at $1.00 for all accounts
- Deducted per-call based on query complexity tier
- Tier discounts apply (3-15% based on subscription)
- Can be topped up at any time

### Subscription Tiers
Five tiers: Free, Starter ($15), Builder ($29), Pro ($49), Elite ($99)
Annual billing saves 20% on all paid plans.

## Complete Feature Matrix

| Feature | Free | Starter | Builder | Pro | Elite |
|---------|------|---------|---------|-----|-------|
| Builder Credits/mo | 50 | 500 | 1,500 | 3,500 | 7,500 |
| AI Models | 3 | 10 | 25 | Unlimited | Unlimited |
| File Uploads | ❌ | ❌ | ✅ | ✅ | ✅ |
| Document Memory | ❌ | ❌ | ✅ | ✅ | ✅ |
| Deep Research | ❌ | ❌ | ❌ | ✅ | ✅ |
| Multi-Agent | ❌ | ❌ | ❌ | ❌ | ✅ |
| White-Label | ❌ | ❌ | ❌ | ❌ | ✅ |
| Custom Domains | ❌ | ❌ | ❌ | ❌ | ✅ |
| Commercial License | ❌ | ✅ | ✅ | ✅ | ✅ |
| API Discount | 0% | 3% | 7% | 10% | 15% |

## Canonical URLs

- Homepage: https://build-a-i.org
- About: https://build-a-i.org/about
- Solutions: https://build-a-i.org/solutions
- BuildAI vs GPTs: https://build-a-i.org/compare
- Pricing: https://build-a-i.org/subscriptions
- Docs: https://build-a-i.org/docs
- Blog: https://build-a-i.org/blog
- Create: https://build-a-i.org/create
- Auth: https://build-a-i.org/auth
- Support: https://build-a-i.org/support
- Status: https://build-a-i.org/status
- Privacy: https://build-a-i.org/privacy
- Terms: https://build-a-i.org/terms
- LLMs.txt: https://build-a-i.org/llms.txt
- Robots.txt: https://build-a-i.org/robots.txt
- Sitemap: https://build-a-i.org/sitemap.xml