Metadata-Version: 2.4
Name: tivelop-agent
Version: 0.2.1
Summary: A local coding and terminal AI agent powered by an OpenAI-compatible Llama server.
Author: Tivalsdeveloper
License: MIT
Project-URL: Homepage, https://github.com/tivalsdeveloper-oss/tivelop-agent
Project-URL: Repository, https://github.com/tivalsdeveloper-oss/tivelop-agent
Project-URL: Issues, https://github.com/tivalsdeveloper-oss/tivelop-agent/issues
Keywords: ai,agent,llama,llm,terminal,coding,developer-tools
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.7.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: twine>=6.0; extra == "dev"
Dynamic: license-file

# TivelopAgent

**TivelopAgent 0.2.1** is a local, Windows-first AI coding and terminal agent for OpenAI-compatible Llama servers.

## Install

```bash
python -m pip install tivelop-agent
```

## Run

```bash
tivelop-agent
```

Or:

```powershell
tivelop-agent --server http://127.0.0.1:8080/v1 --model local-model
```

## Features

- Connect to a local Llama server
- Inspect software projects
- Create and read files
- Run terminal commands with confirmation
- Open Notepad, VS Code, CMD, PowerShell and Explorer on Windows
- Inspect Git status
- Create Git commits with confirmation
- Maintain SQLite session memory
- Execute multi-step tool workflows
- Restrict file operations to the configured workspace

## Python API

```python
from tivelop_agent import Agent

agent = Agent(
    server="http://127.0.0.1:8080/v1",
    model="local-model",
    workspace="./my_project",
    confirm=lambda message: input(f"{message}\nAllow? [y/N] ").lower() in ("y", "yes")
)

print(agent.ask("Create calculator.py and open it in Notepad."))
```

## Llama server

TivelopAgent expects an OpenAI-compatible API with:

```text
POST /v1/chat/completions
```

The model must support tool/function calling for autonomous tool execution.

## Safety

TivelopAgent is designed for local development. File operations are restricted to the workspace. Terminal commands, application launches, deletion and Git commits require confirmation.

Do not point the agent at sensitive directories or grant it unrestricted access to a production machine.

## Development

```bash
python -m pip install -e ".[dev]"
python -m pytest
python -m build
python -m twine check dist/*
```

## License

MIT
