Metadata-Version: 2.4
Name: orbitaven
Version: 0.3.1
Summary: Autonomous Orchestration Platform — Signal. Simulate. Execute.
Author-email: Pinaki <pinaki@orbitaven.ai>
License: MIT License
        
        Copyright (c) 2026 Orbitaven
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://orbitaven.ai
Project-URL: Repository, https://github.com/hatsflickcommerce-hub/orbitaven
Project-URL: Issues, https://github.com/hatsflickcommerce-hub/orbitaven/issues
Project-URL: Documentation, https://github.com/hatsflickcommerce-hub/orbitaven#readme
Keywords: orchestration,automation,ai,agents,workflow,signal,llm,local-ai,multi-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.111.0
Requires-Dist: uvicorn[standard]>=0.29.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: python-jose[cryptography]>=3.3.0
Requires-Dist: bcrypt==4.0.1
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: apscheduler>=3.10.4
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: httpx>=0.27.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: ruff>=0.4.0; extra == "dev"
Dynamic: license-file

# Orbitaven

<p align="center">
  <strong>Autonomous Orchestration Platform</strong><br/>
  Signal · Simulate · Execute
</p>

<p align="center">
  <a href="https://pypi.org/project/orbitaven"><img src="https://img.shields.io/pypi/v/orbitaven.svg" alt="PyPI version"/></a>
  <a href="https://pypi.org/project/orbitaven"><img src="https://img.shields.io/pypi/pyversions/orbitaven.svg" alt="Python versions"/></a>
  <a href="https://github.com/hatsflickcommerce-hub/orbitaven/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"/></a>
  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20Mac%20%7C%20Windows-lightgrey.svg" alt="Platform"/>
  <img src="https://img.shields.io/badge/LLM-Ollama%20%7C%20OpenAI%20%7C%20Anthropic%20%7C%20Kaggle-orange.svg" alt="LLM"/>
</p>

---

Orbitaven is a **local-first autonomous orchestration platform** that watches for signals, builds multi-step workflows, dispatches real AI agents, and executes tasks 24/7 — all through a real-time chat interface running entirely on your own hardware.

No cloud dependency. No SaaS subscription. No data leaving your machine.

---

## Why Orbitaven

Most AI tools wait for you to ask them something. **Orbitaven doesn't wait.**

It monitors your configured signal sources around the clock. When something happens — a price threshold crossed, a keyword detected, an API returning an unexpected value — it builds a workflow, assigns the right agents, simulates the plan, and executes. You stay in control. The platform does the work.
Signal detected → Brain classifies → Workflow generated → Agents dispatched → Result delivered

---

## Key Features

| Feature | Description |
|---------|-------------|
| 🔁 **Signal-driven** | Monitors URLs, RSS feeds, APIs 24/7. Fires workflows on triggers. |
| 🧠 **Brain engine** | Classifies every input — direct answer or multi-step workflow. |
| 🤖 **10 built-in agents** | file, web, shell, memory, summarizer, coder, data, notify, signal, assistant |
| 🌱 **Self-growing** | Describe a new agent in chat. Orbitaven builds and registers it instantly. |
| 🔐 **Credential vault** | AES-128 encrypted API key storage per profile. Never stored in plaintext. |
| 💬 **Context memory** | Extracts semantic meaning from conversations. Surfaces proactive suggestions. |
| 🤝 **Multi-agent negotiation** | Public protocol — external agents register, submit isolated offers, root agent decides. |
| ⚡ **Real-time streaming** | Every workflow step streams output to the UI as it executes. |
| 🌓 **Light + dark mode** | Monochrome sci-fi UI. Fully themeable. |
| 📦 **Model-agnostic** | Ollama (local), Kaggle tunnel, OpenAI, Anthropic, any OpenAI-compatible API. |
| 🖥️ **Local-first** | SQLite, no Docker required, runs on 4GB RAM Ubuntu / Mac / Windows. |

---

## Install

### Linux / Mac
```bash
curl -sSL https://raw.githubusercontent.com/hatsflickcommerce-hub/orbitaven/stage/scripts/install.sh | bash
```

### Windows (PowerShell)
```powershell
irm https://raw.githubusercontent.com/hatsflickcommerce-hub/orbitaven/stage/scripts/install.ps1 | iex
```

### pip
```bash
pip install orbitaven
orbitaven init
orbitaven start
```

### Developers
```bash
git clone https://github.com/hatsflickcommerce-hub/orbitaven.git
cd orbitaven
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
./run.sh
```

Open browser at `http://localhost:8000`

---

## Quick Start

```bash
# 1. Install
pip install orbitaven

# 2. Initialise (creates config, database, default templates)
orbitaven init

# 3. Start
orbitaven start

# 4. Open browser → http://localhost:8000
# 5. Create a profile → configure your LLM → start chatting
```

---

## Supported LLM Providers

| Provider | How |
|----------|-----|
| `ollama` | Local Ollama — `http://localhost:11434` |
| `kaggle_tunnel` | Kaggle ngrok/cloudflare tunnel URL (free GPU) |
| `openai` | OpenAI API key |
| `anthropic` | Anthropic Claude API key |
| `openai_compatible` | LM Studio, Groq, Together, any OpenAI-spec endpoint |

Switch model anytime from Settings panel or by typing in chat.

---

## Built-in Agent Pool

| Agent | Capability |
|-------|-----------|
| `assistant` | General LLM reasoning, writing, answering |
| `file_agent` | Read, write, list, search local files |
| `web_agent` | Browse URLs, DuckDuckGo search (no API key) |
| `shell_agent` | Safe whitelisted shell commands |
| `memory_agent` | Persistent per-profile SQLite memory |
| `summarizer_agent` | LLM-powered content condensing |
| `coder_agent` | Code generation + sandboxed Python execution |
| `data_agent` | CSV/JSON parsing, calculations, statistics |
| `notify_agent` | Alerts, notification log |
| `signal_agent` | URL/RSS/API monitoring |

### Grow your own
You: "Create an agent that fetches my GitHub issues"
Orbitaven: "What's your GitHub token? It will be stored encrypted."
You: "ghp_xxxx"
Orbitaven: ✅ github_agent created and registered.

---

## Chat Commands

| Command | Description |
|---------|-------------|
| `/memory` | Show what Orbitaven remembers about you |
| `/suggest` | Get proactive action suggestions from your context |
| `/signals` | Show all configured signals and active alerts |
| `/agents` | List all available agents |
| `/help` | Show all commands |

---

## Multi-Agent Negotiation Protocol (Phase 8)

External developers can register agents and participate in negotiation rounds:

```bash
# Register your agent (get API key)
POST /api/negotiate/register
{"name": "MyAgent", "description": "...", "capabilities": [...]}

# Submit offer to open session (isolated — never sees other offers)
POST /api/negotiate/offer
X-API-Key: oa_xxxx
{"session_id": "...", "offer": {"price": 5000, "delivery": "3 days", ...}}

# Host triggers root agent evaluation → winner announced
POST /api/negotiate/sessions/{id}/evaluate
```

Information isolation guaranteed — agents never see each other's offers.

---

## CLI Reference

```bash
orbitaven init              # initialise config and database
orbitaven start             # start platform (foreground)
orbitaven start --daemon    # start in background
orbitaven start --reload    # hot reload (development)
orbitaven start --port 9000 # custom port
orbitaven stop              # stop background instance
orbitaven status            # check if running
orbitaven version           # show version
```

---

## Architecture
orbitaven/
├── src/orbitaven/
│   ├── core/
│   │   ├── brain.py             — intent classifier + workflow generator
│   │   ├── agent_bus.py         — inter-agent pub/sub communication
│   │   ├── context_engine.py    — semantic memory extraction
│   │   ├── negotiation_engine.py — multi-agent negotiation protocol
│   │   ├── signal_monitor.py    — 24/7 background daemon
│   │   ├── workflow_manager.py  — state machine
│   │   └── credential_vault.py  — AES encrypted secrets
│   ├── agents/                  — 10 built-in + generated agents
│   ├── api/                     — FastAPI + WebSocket
│   └── ui/                      — Monochrome sci-fi single-page app
├── scripts/
│   ├── install.sh               — Linux/Mac installer
│   └── install.ps1              — Windows installer
└── pyproject.toml               — pip packaging

---

## Hardware Requirements

| Component | Minimum |
|-----------|---------|
| OS | Ubuntu 20.04+ / Mac / Windows |
| RAM | 4GB |
| Storage | 10GB |
| Python | 3.11+ |
| GPU | Not required (use Kaggle tunnel for free GPU inference) |

---

## Build Phases

| Phase | Feature | Status |
|-------|---------|--------|
| 1 | Core — config, DB, profiles, LLM, WebSocket, UI | ✅ |
| 2 | Brain engine — intent routing, workflow state machine | ✅ |
| 3 | Agent pool — 10 built-in agents, real execution | ✅ |
| 4 | Signal system — 24/7 monitor, alerts, one-click launch | ✅ |
| 5 | Agent factory — self-growing agents, credential vault | ✅ |
| 6 | Polish — health dashboard, run.sh, system stats | ✅ |
| 7 | Intelligence — AgentBus, ContextEngine, suggestions, light mode | ✅ |
| 8 | Negotiation — public multi-agent protocol, isolation | ✅ |
| 9 | Cloud — Docker, Telegram/WhatsApp, mobile API | 🔜 |

---

## Contributing

```bash
git clone https://github.com/hatsflickcommerce-hub/orbitaven.git
cd orbitaven
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
```

Issues and PRs welcome at [github.com/hatsflickcommerce-hub/orbitaven](https://github.com/hatsflickcommerce-hub/orbitaven)

---

## License

MIT © 2026 Orbitaven

---

<p align="center">
  <strong>Signal · Simulate · Execute</strong>
</p>
