Metadata-Version: 2.4
Name: pilot-code
Version: 0.1.1
Summary: Coding harness for multi-agent execution and orchestration
Author: AttAditya
License: MIT License
        
        Copyright (c) 2026 AttAditya
        
        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://github.com/AttAditya/pilot
Project-URL: Repository, https://github.com/AttAditya/pilot
Project-URL: Issues, https://github.com/AttAditya/pilot/issues
Keywords: coding-harness,agents,automation,orchestration
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: langex
Dynamic: license-file

# Pilot

A harness for single and group of AI models and their replicas to perform a wide range of tasks, from coding and reasoning to more specialized operations.

## Installation

```sh
# Clone the repository
git clone https://github.com/AttAditya/pilot.git
cd pilot

# Source the development environment
source dev.sh

# Setup and run
dev setup
dev run
```

## About

Pilot is designed to be a flexible and extensible framework for orchestrating interactions between various AI models. It provides a structured way to define roles, contexts, and interactions, allowing developers to create complex workflows and applications with ease.

## Ecosystem Models

- Tili: Modified version of QWEN2.5:7B
  - Chat
  - Summarization
  - Planning
  - Code Generation

## Project Structure

```tree
pilot
├── __init__.py
├── __main__.py
├── data
│   ├── __init__.py
│   ├── content.py
│   ├── context.py
│   ├── control.py
│   └── figures.py
├── formatter
│   ├── __init__.py
│   ├── base.py
│   └── penguin.py
├── io
│   ├── __init__.py
│   ├── base.py
│   ├── console.py
│   └── pipe.py
├── role
│   ├── __init__.py
│   ├── base.py
│   ├── chat.py
│   ├── registry.py
│   └── user.py
└── tools
    ├── __init__.py
    └── base.py
```

### Module Overview

- `data`: managing the states of the Pilot ecosystem
- `formatter`: context and chat history formatting
- `io`: input and output management
- `role`: defining different roles in the ecosystem
- `tools`: tools accessible to the roles

## Ecosystem Philosophy

- Role Based: Each model, agent and role is defined as a "Role" with specific capabilities and responsibilities.
- Limited Context: Roles have access to limited context, encouraging more efficient and relevant interactions. Less dilution and more focus.
- Tool Usage: Roles can utilize tools to perform specific tasks, enhancing their capabilities and allowing for more complex interactions. Some roles exists specifically for tool usage and orchestration.

## Status

Experimental and under active development.  
APIs and structure may evolve as the project grows.

## Links

- [GitHub](https://github.com/attaditya/pilot)
- [License](https://github.com/attaditya/pilot/tree/main/LICENSE)

> _Made with <3 by [AttAditya](https://github.com/AttAditya)_
