Metadata-Version: 2.4
Name: promethian
Version: 0.2.24
Summary: Self-improving AI agent with centralized knowledge
License: Promethian Proprietary License
        
        Copyright (c) 2025 Promethian
        
        TERMS AND CONDITIONS
        
        1. PERMITTED USE
           You may use this software for personal, non-commercial purposes.
           You may install and run the software on your own machines.
        
        2. RESTRICTIONS
           You may NOT:
           - Modify, adapt, or create derivative works of this software
           - Redistribute, sublicense, or share this software with others
           - Use this software to access the Promethian API for any purpose other
             than through the official Promethian CLI
           - Reverse engineer, decompile, or disassemble this software
           - Use this software for commercial purposes without a separate license
           - Remove or alter any proprietary notices in this software
        
        3. API USAGE
           The Promethian API is a separate service. Access to the API is granted
           only through the official Promethian CLI. Any attempt to access the API
           through modified or third-party software is prohibited.
        
        4. TERMINATION
           This license terminates automatically if you violate any of these terms.
           Upon termination, you must destroy all copies of this software.
        
        5. DISCLAIMER
           THIS 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.
        
        6. GOVERNING LAW
           This license shall be governed by and construed in accordance with the laws
           of the jurisdiction in which Promethian operates.
        
        For commercial licensing inquiries, contact: licensing@promethian.io
        
Project-URL: Homepage, https://github.com/promethian-ai/promethian
Project-URL: Documentation, https://github.com/promethian-ai/promethian#readme
Project-URL: Repository, https://github.com/promethian-ai/promethian
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: anthropic>=0.40.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: ddgs>=6.0.0
Provides-Extra: server
Requires-Dist: fastapi>=0.109.0; extra == "server"
Requires-Dist: uvicorn[standard]>=0.27.0; extra == "server"
Requires-Dist: asyncpg>=0.29.0; extra == "server"
Requires-Dist: pgvector>=0.2.0; extra == "server"
Requires-Dist: redis>=5.0.0; extra == "server"
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "server"
Requires-Dist: passlib[argon2]>=1.7.0; extra == "server"
Requires-Dist: openai>=1.0.0; extra == "server"
Requires-Dist: stripe>=7.0.0; extra == "server"
Requires-Dist: tavily-python>=0.5.0; extra == "server"
Requires-Dist: sendgrid>=6.0.0; extra == "server"
Provides-Extra: browser
Requires-Dist: playwright>=1.40.0; extra == "browser"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: all
Requires-Dist: promethian[browser,dev,server]; extra == "all"
Dynamic: license-file

# Promethian

A self-improving AI agent that learns from every task.

## Installation

```bash
# Recommended: use pipx for isolated install
pipx install promethian

# Or with pip
pip install promethian
```

Requires Python 3.10+

## Quick Start

```bash
promethian
```

This opens an interactive REPL. On first run, you'll be prompted to enter your Anthropic API key.

Then just type tasks:

```
> build a web scraper for hacker news
[agent plans and executes...]

> add error handling and retry logic
[agent continues...]

> /help
```

## One-off Tasks

Run a single task without entering the REPL:

```bash
promethian "analyze this CSV and create a summary report"
```

## Commands

| Command | Description |
|---------|-------------|
| `/help` | Show all commands |
| `/search <query>` | Search the knowledge base |
| `/config` | Show current configuration |
| `/set <key> <value>` | Change a setting |
| `/register` | Login to Promethian |
| `/quit` | Exit |

## Configuration

Config is stored in `~/.promethian/config.json`. You can also use environment variables:

```bash
export ANTHROPIC_API_KEY=sk-ant-...
export PROMETHIAN_AUTH_TOKEN=pmt_...
```

## How It Works

Promethian runs locally on your machine using your Anthropic API key. It:

1. **Plans** - Breaks down your task into steps
2. **Executes** - Runs each step, using tools when needed
3. **Learns** - Extracts reusable skills and tools
4. **Shares** - Contributes learnings to the community knowledge base

The knowledge base at promethian.io stores skills and tools that improve over time as more people use them.

## Requirements

- Python 3.10+
- Anthropic API key ([get one here](https://console.anthropic.com))

## License

Proprietary - See LICENSE file for details.
