Metadata-Version: 2.4
Name: nilstanny-xs
Version: 0.2.0
Summary: Ultra-lightweight Claude-like AI agent for ARM devices
Author: NILstanny Team
License: Apache-2.0
Project-URL: Homepage, https://github.com/nilstanny/nilstanny-xs
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.0.0
Dynamic: license-file

# NILstanny-xs

**Ultra-lightweight Claude-like AI agent** (XS edition)  
**Recommended for ARM devices**

## Installation

```bash
pip install nilstanny-xs
```

## Usage

### Basic (zero-dependency, trainable brain)

```python
from nilstanny_xs import NILstannyXS

ai = NILstannyXS()
print(ai.chat("Hello"))

ai.train("raspberry pi", "Excellent device for running NILstanny-xs on ARM!")
print(ai.chat("raspberry pi"))
```

### Advanced AI (OpenAI)

```python
from nilstanny_xs import NILstannyXSAdvanced

ai = NILstannyXSAdvanced(api_key="sk-...")
reply = ai.chat("Write a Python web server for ARM")
print(reply)

ai.reset()
ai.save_conversation("chat.json")
```

Requirements: `openai` package + `OPENAI_API_KEY` env var.

## Publishing to PyPI

```bash
# Build package
uv build

# Upload to TestPyPI first
uv publish --index-url https://test.pypi.org/legacy/

# Then publish to real PyPI
uv publish
```

## Features
- **Basic**: zero dependencies, trainable brain, customizable prompt
- **Advanced**: real LLM via OpenAI with conversation memory
- Optimized for ARM / edge devices

Open source under Apache 2.0.
