Metadata-Version: 2.4
Name: specialagent
Version: 0.7.0
Author-email: Jon Craton <jncraton@gmail.com>
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# specialagent

A minimalist autonomous agent

[![Lint](https://github.com/jncraton/specialagent/actions/workflows/lint.yml/badge.svg)](https://github.com/jncraton/specialagent/actions/workflows/lint.yml)
[![Test](https://github.com/jncraton/specialagent/actions/workflows/test.yml/badge.svg)](https://github.com/jncraton/specialagent/actions/workflows/test.yml)
[![Deploy](https://github.com/jncraton/specialagent/actions/workflows/deploy.yml/badge.svg)](https://github.com/jncraton/specialagent/actions/workflows/deploy.yml)
[![Release](https://github.com/jncraton/specialagent/actions/workflows/release.yml/badge.svg)](https://github.com/jncraton/specialagent/actions/workflows/release.yml)
[![PyPI](https://github.com/jncraton/specialagent/actions/workflows/pypi.yml/badge.svg)](https://github.com/jncraton/specialagent/actions/workflows/pypi.yml)

## Features

- Function calling for shell access and file operations
- Zero-dependency Python implementation

## Security

This package allows LLMs to directly execute shell commands. It should never be used without appropriate sandboxing.
## Usage

```sh
uvx specialagent
```

or

```sh
pipx specialagent
```

## Configuration

In its default configuration, the agent will attempt to use the default model hosted at `http://127.0.0.1:8080/v1/chat/completions` (the llama.cpp default). If a Gemini key is provided, the agent will instead use Gemma 4 31B hosted on AI Studio.

```sh
export GEMINI_API_KEY='your-api-key-here'
```
