jameshiew / simple-agent

Agents with only shell access

Home Page:https://github.com/jameshiew/simple-agent

Repository from Github https://github.comjameshiew/simple-agentRepository from Github https://github.comjameshiew/simple-agent

simple-agent

Give an LLM a regular UNIX environment and a workspace, and let it run shell commands until it completes some task. Runs in a Docker container, edits files in workspace/ and reads tasks and prompts from system/.

Example tasks:

Task is passed as an argument to the simple-agent binary in compose.yml.

Why?

This is for quickly experimenting with what LLMs are able to achieve with only straightforward shell access rather than well-defined tools specified ahead of time like ChatGPT functions. In the future, a more general AI should be able to use just a regular command line to achieve a lot of tasks.

Requirements

Quickstart

ollama pull qwen2.5-coder:32b-instruct-q5_K_M  # if you use a different model, also update the compose.yml
docker compose build
docker compose up  # to use a different task, update the compose.yml

About

Agents with only shell access

https://github.com/jameshiew/simple-agent

License:MIT License


Languages

Language:Rust 92.3%Language:Dockerfile 5.8%Language:Just 1.3%Language:Handlebars 0.6%