Metadata-Version: 2.4
Name: ollama-coder
Version: 0.1.0
Summary: Agentic coding assistant for Ollama
Author: Lalo Morales
License: MIT
Project-URL: Homepage, https://github.com/lalomorales22/ollama-code
Project-URL: Repository, https://github.com/lalomorales22/ollama-code
Project-URL: Issues, https://github.com/lalomorales22/ollama-code/issues
Keywords: ollama,cli,agent,coding-assistant
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ollama>=0.4.0
Dynamic: license-file

# OllamaCode
<img width="477" height="296" alt="Screenshot 2026-01-03 at 10 25 32 AM" src="https://github.com/user-attachments/assets/1bbe5ee1-8f5e-42af-abae-de79d08d31a9" />

Agentic coding assistant for Ollama with tool use, autonomous mode, and project/user configuration.

## Install

From PyPI (after you publish):

```bash
pip install ollama-coder
```

For local development:

```bash
pip install -e .
```

## Run

```bash
ollama-code
```

You will be prompted to choose a model on startup. The selected model can be saved as your default.

You can also run:

```bash
ollama-coder
```

## Common Commands

- `/auto` toggle autonomous mode
- `/models` list installed models
- `/model` show or set the active model
- `/host` show or set the Ollama host (for remote/cloud)
- `/config` show effective configuration
- `/clear` clear conversation history
- `/quit` exit

## Configuration

User config lives at `~/.ollamacode/settings.json`. Example:

```json
{
  "model": "llama3:latest",
  "max_iterations": 25,
  "max_tool_rounds": 8,
  "ollama": {
    "host": "http://127.0.0.1:11434",
    "timeout_sec": 60,
    "headers": {},
    "api_key": ""
  },
  "web_search": {
    "enabled": false,
    "provider": "custom",
    "endpoint": "",
    "api_key": "",
    "timeout_sec": 15,
    "max_results": 5
  }
}
```

You can also set `OLLAMA_HOST` in your environment to point at a remote server. The `/host` command updates the config and rebuilds the client at runtime.

## Requirements

- Ollama server running locally or reachable via `OLLAMA_HOST`
- Python 3.9+

## GitHub

Repository: https://github.com/lalomorales22/ollama-code

## License

MIT
