No project description provided
Project description
specialagent
Designed with educational use in mind, this agent harness is intentionally only a few hundred lines of readable, dependency-free Python.
Features
- Tool use. The agent has 4 tools:
exec- Runbashcommandswrite- Overwrites the contents of a filereplace- Find and replace in fileexit- Terminate session
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://127.0.0.1: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_MODEL=gemma-4-31b-it
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file specialagent-0.9.0.tar.gz.
File metadata
- Download URL: specialagent-0.9.0.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc00a652a566dbae1ef0869f53cd8016f24c889c58ca3d7223aca2ce9b1afd81
|
|
| MD5 |
d0494541e78eac2f290e7c6bf6f3331c
|
|
| BLAKE2b-256 |
361be978297aaee3debe565b0e9fbdd0fc1f93e1aab5b3a0743a0e0f8095826b
|
File details
Details for the file specialagent-0.9.0-py3-none-any.whl.
File metadata
- Download URL: specialagent-0.9.0-py3-none-any.whl
- Upload date:
- Size: 5.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
affa492c59941d1809a9218eb904addae4924c8882fe48e0d89f7006e1f5f225
|
|
| MD5 |
292689b68eef5625647e17d55b5d9e09
|
|
| BLAKE2b-256 |
38bebee8718f1525ffbd633569480a6f541a23cd621a9fa999744e6696d4c5bb
|
