specialagent 😎
An agent is just something that acts (agent comes from the Latin agere, to do). Of course, all computer programs do something, but computer agents are expected to do more: operate autonomously, perceive their environment, persist over a prolonged time period, adapt to change, and create and pursue goals.
Designed with educational use in mind, this agent harness is intentionally only a few hundred lines of readable, dependency-free Python. It acts on its environment by running shell commands and receives output of those commands as percepts to drive subsequent actions.
Features
- Tool use
exec- RunbashcommandswriteFile- Overwrites the contents of a fileeditFile- Find and replace in file
- Prefetching
- Run
cat {filename}for any mentioned files that exist - Run
cat {skill.md}for any skills mentioned by name near the start of the prompt - Run
cat makefileand similar for common project files
- Run
Security
This package allows LLMs to directly execute shell commands. It should never be used without appropriate sandboxing.
Usage
uvx specialagent
or
pipx specialagent
Configuration
In its default configuration, the agent will attempt to use the model hosted at http://localhost:8080/v1/chat/completions (the llama.cpp default). Alternatives may be provided by env variables. For example, to use Gemma 4 31B hosted on AI Studio:
export LLM_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
export LLM_API_KEY=your-api-key-here
export LLM_REASONING_EFFORT=high
export LLM_MODEL=gemma-4-31b-it
1 maintainer
Metadata
1 maintainer
Release files for specialagent 0.43.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| specialagent-0.43.0.tar.gz | 6.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| specialagent-0.43.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.4 kB
Release files / specialagent-0.43.0.tar.gz
| Download URL | specialagent-0.43.0.tar.gz |
|---|---|
| Size | 6.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f57c04bee39559f960492a5f3d3f20189ccae27f1e39471861c92ca4a8f61c67
|
|
BLAKE2b-256 checksum How to use checksums |
059f53ac5192d5f302b8db91f4a075d319553fda2f85151eb58c931c37a3a875
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / specialagent-0.43.0-py3-none-any.whl
| Download URL | specialagent-0.43.0-py3-none-any.whl |
|---|---|
| Size | 5.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a37ab0159e92a6c26a53a76699e8d3a1f85b64e112c443b63d5206125bfad518
|
|
BLAKE2b-256 checksum How to use checksums |
690902fe8e85bb986dce7ad5012effaa228003786d7bcce7d08602b9d770f320
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for specialagent 0.43.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
