ottopilot 0.1.0__tar.gz

ottopilot-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package + dev deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest -q

ottopilot-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish to PyPI
+
+# Publishes on every pushed version tag (e.g. v0.1.0) using PyPI Trusted
+# Publishing (OIDC) — no API token/secret required.
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for Trusted Publishing (OIDC)
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ottopilot-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test / tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# OttoAI runtime data (if ever created inside repo)
+.ottoai/
+
+# OS / editor
+.DS_Store
+*.swp
+.idea/
+.vscode/

ottopilot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 arshad2108
+
+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.

ottopilot-0.1.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.5
+Name: ottopilot
+Version: 0.1.0
+Summary: OttoAI — a local-first, extensible coding agent (Copilot-CLI style) with Ollama by default and optional cloud providers.
+Project-URL: Homepage, https://github.com/arshad2108/OttoAI
+Project-URL: Repository, https://github.com/arshad2108/OttoAI
+Project-URL: Issues, https://github.com/arshad2108/OttoAI/issues
+Author-email: arshad2108 <warsiarshad384@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 arshad2108
+        
+        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.
+License-File: LICENSE
+Keywords: agent,cli,coding-assistant,llm,local-first,ollama
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: rich>=13.7
+Requires-Dist: tomli-w>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: embeddings
+Requires-Dist: numpy>=1.26; extra == 'embeddings'
+Description-Content-Type: text/markdown
+
+# OttoAI
+
+A **local-first, extensible coding agent** for your terminal — think "Copilot CLI, but yours."
+Runs on local models (Ollama / Qwen3) by default, works fully offline, and can optionally
+use cloud providers (OpenAI, Anthropic, Gemini, Azure, OpenRouter, or any OpenAI-compatible
+endpoint) when you choose to turn them on.
+
+## Features
+
+- 🧠 **Local by default** — Ollama + Qwen3 out of the box, no cloud required.
+- 🔌 **Cloud-optional & pluggable** — flip to online and use OpenAI / Claude / Gemini / Azure
+  / OpenRouter / any OpenAI-compatible server via config.
+- 🛠️ **Real agent tools** — shell, file read/write/edit, grep/glob code search, git, web fetch,
+  cross-session history search, and MCP (Model Context Protocol) servers.
+- 💾 **Sessions + memory** — every conversation is persisted in SQLite, with FTS5 keyword
+  search and optional embeddings for semantic recall across past sessions.
+- ♻️ **Conversation compaction** — long chats are automatically summarized to stay within context,
+  while the full history stays searchable.
+- 🧩 **Extensible** — add providers/tools via pip entry points **or** drop a `.py` file in
+  `~/.ottoai/plugins/`.
+
+## Install
+
+```bash
+pip install ottopilot        # from PyPI (once published)
+# or, from source:
+pip install -e .
+```
+
+Install [Ollama](https://ollama.com) and pull the default model:
+
+```bash
+otto pull qwen3
+```
+
+## Usage
+
+```bash
+otto                      # interactive REPL (local-first)
+otto chat "explain this repo"
+otto chat --provider openai --model gpt-4o "review my diff"
+otto models               # list models for the default provider
+otto sessions             # list past sessions
+otto resume               # resume the latest session
+otto search "auth bug"    # search across all past sessions
+otto config init          # write ~/.ottoai/config.toml to customize
+```
+
+### In the REPL
+
+```
+/model <name>        switch model
+/provider <name> [m] switch provider
+/online  /local      toggle cloud access
+/stream              toggle streaming output
+/think [on|off]      toggle model reasoning (faster vs. higher quality)
+/search <query>      recall past sessions
+/remember subj | fact store a durable fact
+/compact             compress the current conversation
+/tools  /sessions  /memory  /help  /quit
+```
+
+## Configuration
+
+Config lives at `~/.ottoai/config.toml` (run `otto config init`). Highlights:
+
+```toml
+local_only = true          # set false (or /online) to allow cloud providers
+default_provider = "ollama"
+default_model = "qwen3"
+stream = true              # token-by-token output (/stream to toggle)
+think = true               # model reasoning: true = higher quality, false = faster (/think)
+
+[compaction]
+enabled = true
+trigger_messages = 40
+keep_recent = 12
+
+[embeddings]
+enabled = false            # set true for semantic cross-session search
+provider = "ollama"
+model = "nomic-embed-text"
+
+[providers.openai]
+type = "openai_compatible"
+base_url = "https://api.openai.com/v1"
+api_key_env = "OPENAI_API_KEY"
+
+[mcp_servers.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
+```
+
+## Extending OttoAI
+
+**Local plugin** — create `~/.ottoai/plugins/my_tool.py`:
+
+```python
+from ottoai.tools import Tool
+
+class HelloTool(Tool):
+    name = "hello"
+    description = "Say hello"
+    parameters = {"type": "object", "properties": {"who": {"type": "string"}}}
+    def run(self, who="world", **_):
+        return f"Hello, {who}!"
+
+TOOLS = [HelloTool]
+# PROVIDERS = {"my_type": MyProviderClass}  # providers work the same way
+```
+
+**Pip plugin** — expose `ottoai.tools` / `ottoai.providers` entry points in your package.
+
+## License
+
+MIT

ottopilot-0.1.0/README.md

@@ -0,0 +1,116 @@
+# OttoAI
+
+A **local-first, extensible coding agent** for your terminal — think "Copilot CLI, but yours."
+Runs on local models (Ollama / Qwen3) by default, works fully offline, and can optionally
+use cloud providers (OpenAI, Anthropic, Gemini, Azure, OpenRouter, or any OpenAI-compatible
+endpoint) when you choose to turn them on.
+
+## Features
+
+- 🧠 **Local by default** — Ollama + Qwen3 out of the box, no cloud required.
+- 🔌 **Cloud-optional & pluggable** — flip to online and use OpenAI / Claude / Gemini / Azure
+  / OpenRouter / any OpenAI-compatible server via config.
+- 🛠️ **Real agent tools** — shell, file read/write/edit, grep/glob code search, git, web fetch,
+  cross-session history search, and MCP (Model Context Protocol) servers.
+- 💾 **Sessions + memory** — every conversation is persisted in SQLite, with FTS5 keyword
+  search and optional embeddings for semantic recall across past sessions.
+- ♻️ **Conversation compaction** — long chats are automatically summarized to stay within context,
+  while the full history stays searchable.
+- 🧩 **Extensible** — add providers/tools via pip entry points **or** drop a `.py` file in
+  `~/.ottoai/plugins/`.
+
+## Install
+
+```bash
+pip install ottopilot        # from PyPI (once published)
+# or, from source:
+pip install -e .
+```
+
+Install [Ollama](https://ollama.com) and pull the default model:
+
+```bash
+otto pull qwen3
+```
+
+## Usage
+
+```bash
+otto                      # interactive REPL (local-first)
+otto chat "explain this repo"
+otto chat --provider openai --model gpt-4o "review my diff"
+otto models               # list models for the default provider
+otto sessions             # list past sessions
+otto resume               # resume the latest session
+otto search "auth bug"    # search across all past sessions
+otto config init          # write ~/.ottoai/config.toml to customize
+```
+
+### In the REPL
+
+```
+/model <name>        switch model
+/provider <name> [m] switch provider
+/online  /local      toggle cloud access
+/stream              toggle streaming output
+/think [on|off]      toggle model reasoning (faster vs. higher quality)
+/search <query>      recall past sessions
+/remember subj | fact store a durable fact
+/compact             compress the current conversation
+/tools  /sessions  /memory  /help  /quit
+```
+
+## Configuration
+
+Config lives at `~/.ottoai/config.toml` (run `otto config init`). Highlights:
+
+```toml
+local_only = true          # set false (or /online) to allow cloud providers
+default_provider = "ollama"
+default_model = "qwen3"
+stream = true              # token-by-token output (/stream to toggle)
+think = true               # model reasoning: true = higher quality, false = faster (/think)
+
+[compaction]
+enabled = true
+trigger_messages = 40
+keep_recent = 12
+
+[embeddings]
+enabled = false            # set true for semantic cross-session search
+provider = "ollama"
+model = "nomic-embed-text"
+
+[providers.openai]
+type = "openai_compatible"
+base_url = "https://api.openai.com/v1"
+api_key_env = "OPENAI_API_KEY"
+
+[mcp_servers.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
+```
+
+## Extending OttoAI
+
+**Local plugin** — create `~/.ottoai/plugins/my_tool.py`:
+
+```python
+from ottoai.tools import Tool
+
+class HelloTool(Tool):
+    name = "hello"
+    description = "Say hello"
+    parameters = {"type": "object", "properties": {"who": {"type": "string"}}}
+    def run(self, who="world", **_):
+        return f"Hello, {who}!"
+
+TOOLS = [HelloTool]
+# PROVIDERS = {"my_type": MyProviderClass}  # providers work the same way
+```
+
+**Pip plugin** — expose `ottoai.tools` / `ottoai.providers` entry points in your package.
+
+## License
+
+MIT

ottopilot-0.1.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ottopilot"
+version = "0.1.0"
+description = "OttoAI — a local-first, extensible coding agent (Copilot-CLI style) with Ollama by default and optional cloud providers."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+authors = [{ name = "arshad2108", email = "warsiarshad384@gmail.com" }]
+keywords = ["llm", "agent", "coding-assistant", "ollama", "local-first", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "httpx>=0.27",
+    "rich>=13.7",
+    "prompt_toolkit>=3.0",
+    "tomli-w>=1.0",
+]
+
+[project.optional-dependencies]
+embeddings = ["numpy>=1.26"]
+dev = ["pytest>=8.0"]
+
+[project.scripts]
+otto = "ottoai.cli:main"
+ottoai = "ottoai.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/arshad2108/OttoAI"
+Repository = "https://github.com/arshad2108/OttoAI"
+Issues = "https://github.com/arshad2108/OttoAI/issues"
+
+# Built-in providers and tools are registered as entry points so third-party
+# plugins can extend OttoAI the exact same way.
+[project.entry-points."ottoai.providers"]
+openai_compatible = "ottoai.providers.openai_compatible:OpenAICompatibleProvider"
+anthropic = "ottoai.providers.anthropic:AnthropicProvider"
+gemini = "ottoai.providers.gemini:GeminiProvider"
+
+[project.entry-points."ottoai.tools"]
+shell = "ottoai.tools.shell:ShellTool"
+read_file = "ottoai.tools.files:ReadFileTool"
+write_file = "ottoai.tools.files:WriteFileTool"
+edit_file = "ottoai.tools.files:EditFileTool"
+list_dir = "ottoai.tools.files:ListDirTool"
+grep = "ottoai.tools.search:GrepTool"
+glob = "ottoai.tools.search:GlobTool"
+web_fetch = "ottoai.tools.web:WebFetchTool"
+git = "ottoai.tools.git:GitTool"
+search_history = "ottoai.tools.history:SearchHistoryTool"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ottoai"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

ottopilot-0.1.0/src/ottoai/__init__.py

@@ -0,0 +1,7 @@
+"""OttoAI — a local-first, extensible coding agent."""
+
+__version__ = "0.1.0"
+
+from .types import Message, ToolCall, ToolResult, ChatResponse
+
+__all__ = ["Message", "ToolCall", "ToolResult", "ChatResponse", "__version__"]

ottopilot-0.1.0/src/ottoai/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())