ollaagent 0.1.0__tar.gz

ollaagent-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

ollaagent-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

ollaagent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 github010000
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ollaagent-0.1.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: ollaagent
+Version: 0.1.0
+Summary: Local LLM agent powered by ollama — memory, plan mode, subagents
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: ollama==0.6.1
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich==14.3.3
+Description-Content-Type: text/markdown
+
+# ollaAgent
+
+A local LLM agent powered by [ollama](https://ollama.com) — with persistent memory, plan mode, and parallel subagents.
+
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Agent Loop** | Iterative tool-calling loop with `run_python`, `run_bash`, `read_file`, `write_file`, `list_files` |
+| **Persistent Memory** | JSON-backed memory with `/memory add/list/search/clear` commands |
+| **Session Saving** | Conversation history auto-saved to `.agents/sessions/` on exit |
+| **Plan Mode** | `/plan <task>` — generates a structured step-by-step plan without executing tools |
+| **Subagents** | `/subagent` — runs multiple ollama instances in parallel via `multiprocessing.Pool` |
+| **Permission Control** | Configurable allow/deny patterns for bash commands |
+| **Cloudflare Access** | Supports CF-Access headers for tunneled ollama endpoints |
+
+## Requirements
+
+- Python 3.11+
+- [ollama](https://ollama.com) running locally (or via Cloudflare Access)
+- [uv](https://docs.astral.sh/uv/)
+
+## Installation
+
+```bash
+git clone https://github.com/github010000/ollaAgent
+cd ollaAgent
+uv sync
+```
+
+## Usage
+
+```bash
+# Start the agent
+uv run ollaagent
+
+# With a specific model
+uv run ollaagent --model qwen2.5-coder:7b
+
+# With a remote ollama host
+uv run ollaagent --host https://your-ollama.example.com
+```
+
+## Built-in Commands
+
+| Command | Description |
+|---------|-------------|
+| `/plan <task>` | Generate a step-by-step plan (no execution) |
+| `/subagent` | Run tasks in parallel across multiple ollama instances |
+| `/memory add <text>` | Add an entry to persistent memory |
+| `/memory list` | List all memory entries |
+| `/memory search <query>` | Search memory by keyword |
+| `/memory clear` | Clear all memory entries |
+| `/exit` | Exit the agent |
+
+## Subagent Usage
+
+Single model across all tasks:
+```
+/subagent
+> --model llama3:8b task one | task two | task three
+```
+
+Per-task model assignment:
+```
+> @qwen2.5-coder:7b write a sorting algorithm | @llama3:8b explain it
+```
+
+## Configuration
+
+Create a `.env` file in the project root:
+
+```env
+OLLAMA_HOST=http://localhost:11434
+CF_CLIENT_ID=
+CF_CLIENT_SECRET=
+```
+
+## Project Structure
+
+```
+ollaAgent/
+├── agent.py          # Main agent loop & CLI entry point
+├── memory.py         # Persistent memory (JSON)
+├── plan_mode.py      # Plan-only mode (tools=[])
+├── subagent.py       # Parallel subagents via multiprocessing
+├── tool_bash.py      # Bash tool with permission control
+├── permissions.py    # Allow/deny pattern matching
+├── config_loader.py  # YAML config & system prompt builder
+└── ollama_client.py  # Ollama client factory
+```
+
+## Running Tests
+
+```bash
+uv run pytest
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

ollaagent-0.1.0/README.md

@@ -0,0 +1,104 @@
+# ollaAgent
+
+A local LLM agent powered by [ollama](https://ollama.com) — with persistent memory, plan mode, and parallel subagents.
+
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Agent Loop** | Iterative tool-calling loop with `run_python`, `run_bash`, `read_file`, `write_file`, `list_files` |
+| **Persistent Memory** | JSON-backed memory with `/memory add/list/search/clear` commands |
+| **Session Saving** | Conversation history auto-saved to `.agents/sessions/` on exit |
+| **Plan Mode** | `/plan <task>` — generates a structured step-by-step plan without executing tools |
+| **Subagents** | `/subagent` — runs multiple ollama instances in parallel via `multiprocessing.Pool` |
+| **Permission Control** | Configurable allow/deny patterns for bash commands |
+| **Cloudflare Access** | Supports CF-Access headers for tunneled ollama endpoints |
+
+## Requirements
+
+- Python 3.11+
+- [ollama](https://ollama.com) running locally (or via Cloudflare Access)
+- [uv](https://docs.astral.sh/uv/)
+
+## Installation
+
+```bash
+git clone https://github.com/github010000/ollaAgent
+cd ollaAgent
+uv sync
+```
+
+## Usage
+
+```bash
+# Start the agent
+uv run ollaagent
+
+# With a specific model
+uv run ollaagent --model qwen2.5-coder:7b
+
+# With a remote ollama host
+uv run ollaagent --host https://your-ollama.example.com
+```
+
+## Built-in Commands
+
+| Command | Description |
+|---------|-------------|
+| `/plan <task>` | Generate a step-by-step plan (no execution) |
+| `/subagent` | Run tasks in parallel across multiple ollama instances |
+| `/memory add <text>` | Add an entry to persistent memory |
+| `/memory list` | List all memory entries |
+| `/memory search <query>` | Search memory by keyword |
+| `/memory clear` | Clear all memory entries |
+| `/exit` | Exit the agent |
+
+## Subagent Usage
+
+Single model across all tasks:
+```
+/subagent
+> --model llama3:8b task one | task two | task three
+```
+
+Per-task model assignment:
+```
+> @qwen2.5-coder:7b write a sorting algorithm | @llama3:8b explain it
+```
+
+## Configuration
+
+Create a `.env` file in the project root:
+
+```env
+OLLAMA_HOST=http://localhost:11434
+CF_CLIENT_ID=
+CF_CLIENT_SECRET=
+```
+
+## Project Structure
+
+```
+ollaAgent/
+├── agent.py          # Main agent loop & CLI entry point
+├── memory.py         # Persistent memory (JSON)
+├── plan_mode.py      # Plan-only mode (tools=[])
+├── subagent.py       # Parallel subagents via multiprocessing
+├── tool_bash.py      # Bash tool with permission control
+├── permissions.py    # Allow/deny pattern matching
+├── config_loader.py  # YAML config & system prompt builder
+└── ollama_client.py  # Ollama client factory
+```
+
+## Running Tests
+
+```bash
+uv run pytest
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

ollaagent-0.1.0/README_ko.md

@@ -0,0 +1,104 @@
+# ollaAgent
+
+[ollama](https://ollama.com) 기반 로컬 LLM 에이전트 — 영구 메모리, 플랜 모드, 병렬 서브에이전트를 지원합니다.
+
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## 주요 기능
+
+| 기능 | 설명 |
+|------|------|
+| **에이전트 루프** | `run_python`, `run_bash`, `read_file`, `write_file`, `list_files` 도구를 활용한 반복 실행 루프 |
+| **영구 메모리** | JSON 파일 기반 메모리. `/memory add/list/search/clear` 명령으로 관리 |
+| **세션 저장** | 종료 시 대화 히스토리를 `.agents/sessions/`에 자동 저장 |
+| **플랜 모드** | `/plan <태스크>` — 도구 실행 없이 단계별 계획만 생성 |
+| **서브에이전트** | `/subagent` — `multiprocessing.Pool`로 여러 ollama 인스턴스를 병렬 실행 |
+| **권한 제어** | bash 명령에 대한 허용/거부 패턴 설정 |
+| **Cloudflare Access** | 터널링된 ollama 엔드포인트에 CF-Access 헤더 지원 |
+
+## 요구사항
+
+- Python 3.11 이상
+- [ollama](https://ollama.com) 로컬 실행 중 (또는 Cloudflare Access 경유)
+- [uv](https://docs.astral.sh/uv/)
+
+## 설치
+
+```bash
+git clone https://github.com/github010000/ollaAgent
+cd ollaAgent
+uv sync
+```
+
+## 실행
+
+```bash
+# 에이전트 시작
+uv run ollaagent
+
+# 모델 지정
+uv run ollaagent --model qwen2.5-coder:7b
+
+# 원격 ollama 호스트 지정
+uv run ollaagent --host https://your-ollama.example.com
+```
+
+## 내장 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `/plan <태스크>` | 단계별 계획 생성 (도구 실행 없음) |
+| `/subagent` | 여러 태스크를 병렬로 실행 |
+| `/memory add <내용>` | 영구 메모리에 항목 추가 |
+| `/memory list` | 전체 메모리 목록 출력 |
+| `/memory search <키워드>` | 키워드로 메모리 검색 |
+| `/memory clear` | 전체 메모리 삭제 |
+| `/exit` | 에이전트 종료 |
+
+## 서브에이전트 사용법
+
+단일 모델로 여러 태스크 병렬 실행:
+```
+/subagent
+> --model llama3:8b 태스크1 | 태스크2 | 태스크3
+```
+
+태스크별 모델 지정:
+```
+> @qwen2.5-coder:7b 정렬 알고리즘 작성 | @llama3:8b 코드 설명
+```
+
+## 환경 설정
+
+프로젝트 루트에 `.env` 파일을 생성합니다:
+
+```env
+OLLAMA_HOST=http://localhost:11434
+CF_CLIENT_ID=
+CF_CLIENT_SECRET=
+```
+
+## 프로젝트 구조
+
+```
+ollaAgent/
+├── agent.py          # 메인 에이전트 루프 & CLI 진입점
+├── memory.py         # 영구 메모리 (JSON)
+├── plan_mode.py      # 플랜 전용 모드 (tools=[])
+├── subagent.py       # multiprocessing 기반 병렬 서브에이전트
+├── tool_bash.py      # 권한 제어가 포함된 bash 도구
+├── permissions.py    # 허용/거부 패턴 매칭
+├── config_loader.py  # YAML 설정 & 시스템 프롬프트 빌더
+└── ollama_client.py  # ollama 클라이언트 팩토리
+```
+
+## 테스트 실행
+
+```bash
+uv run pytest
+```
+
+## 라이선스
+
+MIT — 자세한 내용은 [LICENSE](LICENSE)를 참조하세요.

ollaagent-0.1.0/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from ollaagent!")
+
+
+if __name__ == "__main__":
+    main()