Metadata-Version: 2.4
Name: sae-aos
Version: 0.1.1
Summary: Sovereign Autonomy Engine / Artificial Organism System
Home-page: https://github.com/pricelesskevin44-coder/SAE_AOS
Author: Kevin
License: MIT License
        
Project-URL: Homepage, https://github.com/pricelesskevin44-coder/SAE_AOS
Project-URL: Documentation, https://github.com/pricelesskevin44-coder/SAE_AOS
Project-URL: Source, https://github.com/pricelesskevin44-coder/SAE_AOS
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: rich
Requires-Dist: websockets
Requires-Dist: fastapi
Requires-Dist: uvicorn
Dynamic: license-file

Sovereign Autonomy Engine (SAE‑AOS)

A high‑level autonomy and decision‑making SDK for robotics and intelligent agents.

The Sovereign Autonomy Engine (SAE‑AOS) provides a clean, Python‑based interface for integrating advanced autonomous decision‑making into robots, simulations, and intelligent systems.  
This SDK exposes a simple, stable API that lets robotics engineers send sensor data, set goals, and retrieve actions — without exposing the internal engine architecture.

SAE‑AOS is designed for teams who want to evaluate or integrate next‑generation autonomy without dealing with complex behavior trees, brittle state machines, or custom control logic.

---

🚀 Features
- Simple Python API for sending observations and receiving actions  
- Goal‑driven autonomy with a clean, declarative interface  
- Deterministic decision loop suitable for real robots and simulation  
- Lightweight integration layer that works with ROS, Isaac Sim, Webots, Mujoco, and custom robotics stacks  
- Zero engine exposure — your system stays proprietary while users interact through the SDK  
- Fast to evaluate — install and run a demo in minutes  

---

🧠 Why Robotics Teams Use SAE‑AOS
Robotics companies use this SDK to:

- test advanced autonomy in simulation  
- integrate a decision‑making engine into their robot stack  
- evaluate new control strategies without rewriting their system  
- compare your autonomy engine against their existing planner or behavior tree  
- prototype intelligent behaviors quickly  

The SDK is the safe, stable interface to the underlying autonomy engine — ideal for evaluation, integration, and experimentation.

---

📦 Installation

`bash
pip install sae-aos
`

---

🧩 Quickstart Example

`python
from sae_aos import Agent

agent = Agent()

agent.setgoal("navigateto_waypoint")

while True:
    obs = getrobotsensor_data()
    action = agent.decide(obs)
    applyrobotaction(action)
`

This minimal loop shows how to connect your robot or simulator to the autonomy engine.

---

🔗 Use Cases
- Mobile robots  
- Warehouse automation  
- Manipulation and arms  
- Drones and UAVs  
- Simulation‑only research  
- Multi‑agent systems  
- Autonomous navigation and decision‑making  

---

📘 Documentation
Documentation, examples, and integration guides are available inside the package and will expand with future releases.

---

🛡️ License
Choose your license here (MIT, Apache, or proprietary).
