agent-mini 0.1.0__tar.gz

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

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint with ruff
+        run: uv run ruff check src/ tests/
+
+      - name: Run tests
+        run: uv run pytest tests/ -v

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

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

agent_mini-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Byte-compiled / optimized
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+node_modules/
+
+# Config (contains secrets)
+# ~/.agent-mini/ is outside the repo, but just in case:
+config.json
+.pytest_cache/
+.ruff_cache/

agent_mini-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,105 @@
+# Contributing to Agent Mini
+
+Thanks for your interest in contributing! Agent Mini is intentionally lean — every line of code must earn its place.
+
+## Development Setup
+
+```bash
+# Clone
+git clone https://github.com/mohsinkaleem/agent-mini.git
+cd agent-mini
+
+# Install with dev dependencies (uses uv)
+uv sync --extra dev
+
+# Run tests
+uv run pytest tests/ -v
+
+# Lint
+uv run ruff check src/ tests/
+```
+
+## Project Principles
+
+- **Stay lean.** The core is ~3,500 LOC. Don't add frameworks, heavy abstractions, or dependencies unless absolutely necessary.
+- **Zero-framework.** Pure `httpx` + `asyncio`. No LangChain, no LiteLLM, no abstractions-on-abstractions.
+- **One file, one job.** Each module has a clear, single responsibility.
+- **Tests are required.** Every new feature or bug fix needs a test in `tests/`.
+
+## How to Contribute
+
+### Bug Reports
+
+Open an issue with:
+1. What you expected
+2. What happened
+3. Steps to reproduce
+4. Your provider/model (e.g., Ollama + qwen2.5:7b)
+
+### Pull Requests
+
+1. Fork the repo and create a branch from `main`.
+2. Make your changes — keep the diff small and focused.
+3. Add or update tests in `tests/`.
+4. Run the test suite: `uv run pytest tests/ -v`
+5. Run the linter: `uv run ruff check src/ tests/`
+6. Open a PR with a clear description of *what* and *why*.
+
+### What We Welcome
+
+- Bug fixes
+- New LLM provider integrations (following `providers/base.py` interface)
+- New built-in tools (keep them small and self-contained)
+- Plugin examples
+- Documentation improvements
+- Performance improvements (with benchmarks)
+
+### What We Avoid
+
+- Adding large dependencies (if it can be done with stdlib, do it with stdlib)
+- Framework integrations (LangChain, LlamaIndex, etc.)
+- Features that increase complexity without clear user value
+- Refactors that change everything but fix nothing
+
+## Code Style
+
+- Python 3.11+, type hints where they help readability.
+- Ruff for linting (`ruff check`).
+- No docstrings required for obvious methods — code should be self-explanatory.
+- Prefer `match/case` for dispatch over `if/elif` chains.
+
+## Project Structure
+
+```
+src/agent_mini/
+├── cli.py              # CLI entry point (Click)
+├── config.py           # Typed config loading
+├── bus.py              # Multi-channel message routing
+├── sessions.py         # Session persistence
+├── agent/
+│   ├── loop.py         # Core ReAct agent loop
+│   ├── context.py      # System prompt builder
+│   ├── memory.py       # Persistent JSON memory + TF-IDF search
+│   ├── tools.py        # Built-in tools + plugin loader
+│   ├── token_estimator.py  # Token counting + model tier classification
+│   └── vision.py       # Image detection + encoding
+├── providers/
+│   ├── base.py         # Provider interface + tool call parsing
+│   ├── ollama.py       # Ollama provider
+│   ├── gemini.py       # Google Gemini provider
+│   ├── github_copilot.py  # GitHub Copilot (OAuth device flow)
+│   └── local.py        # Any OpenAI-compatible endpoint
+└── channels/
+    ├── base.py         # Channel interface
+    └── telegram.py     # Telegram bot channel
+```
+
+## Releasing
+
+Releases are automated via GitHub Actions:
+
+1. Update `version` in both `pyproject.toml` and `src/agent_mini/__init__.py`.
+2. Commit: `git commit -am "release: v0.2.0"`
+3. Tag: `git tag v0.2.0`
+4. Push: `git push && git push --tags`
+5. Create a GitHub Release from the tag — PyPI publish runs automatically.

agent_mini-0.1.0/LICENSE

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