# OURS! (HalfBot): Sovereign Intelligence Orchestration Platform

OURS! is a platform for deploying and managing autonomous AI agents in a controlled, transparent, and scalable environment.

## 🎯 Project Overview
- **Identity**: "Non-Rented Intelligence."
- **Philosophy**: "Our-Brain Our-Bot" — A joint thinking system where human intent (intuition) and machine scale (execution) resonate.
- **Mission**: Bridging the semantic gap between human judgment and machine scale.
- **Core Value**: Full transparency of agent reasoning and sovereign control over data and weights.

## 🏗 Architecture
- **Exocortex Pattern**: The agent is a personal node in your own infrastructure, not a corporate service.
- **Hexagonal/Clean Architecture**: Strict separation between UI, Bridge, Runtime, Data Access, and Adapter layers.
- **Runtime Core**: Deterministic state machine (`BotEngine`) and lifecycle coordinator (`RuntimeManager`).
- **Observability**: `CausalGraph` visualizes the "tree of thoughts" for every agent decision.
- **Data Sovereignty**: Zero cloud dependency.

## 🚀 Key Features
- **Persistent Agents**: Bots live beyond the browser session, state is synchronized via repositories.
- **Hybrid Intelligence**: Orchestrates local tools (e.g., Krita plugins) and cloud-based LLMs (Gemini).
- **Billing & Tokens**: Unified credit system for web and local plugin usage.
- **Developer First**: API-centric design with robust SDKs and bridges for local software.

## 🛠 Technology Stack
- **Frontend**: Next.js (App Router), React, Framer Motion.
- **AI**: Gemini 1.5 Pro/Flash.
- **Database**: Firebase (Migrating to PostgreSQL).
- **Styling**: Vanilla CSS (Cyberpunk/Terminal Aesthetic).

## 🔗 Resources
- [Main Website](https://halfbot.run)
- [Manifesto](https://halfbot.run/manifesto)
- [System Status](https://halfbot.run/status)
- [Billing & API](https://halfbot.run/runtime/billing)

## 🔐 Security & OPSEC
- Environment variable-based configuration.
- Localized data storage priority.
- End-to-end audit logs for all AI actions.

---
*Last Updated: 2026-05-16*
*Status: Agent-Ready Node*