anythink 0.1.0__tar.gz

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

@@ -0,0 +1,107 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-typecheck:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: ruff check src/
+
+      - name: Format check (black)
+        run: black --check src/ tests/
+
+      - name: Type check (mypy)
+        run: mypy src/anythink
+
+  security:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Security scan (bandit)
+        run: bandit -r src/anythink -c pyproject.toml
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    env:
+      PYTHON_KEYRING_BACKEND: keyrings.alt.file.PlaintextKeyring
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests with coverage
+        run: pytest tests/ -v --cov-report=xml
+
+      - name: Upload coverage report
+        if: matrix.python-version == '3.11'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage.xml
+          retention-days: 7
+
+  build:
+    name: Build & Verify Package
+    runs-on: ubuntu-latest
+    needs: [lint-typecheck, security, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build distribution
+        run: python -m build
+
+      - name: Verify distribution metadata
+        run: twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7

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

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build:
+    name: Build & Verify
+    runs-on: ubuntu-latest
+    env:
+      PYTHON_KEYRING_BACKEND: keyrings.alt.file.PlaintextKeyring
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run full test suite
+        run: pytest tests/ -v --cov-fail-under=80
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build distribution
+        run: python -m build
+
+      - name: Verify distribution metadata
+        run: twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment: pypi
+    permissions:
+      id-token: write   # required for OIDC trusted publishing
+      contents: read
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

anythink-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Byte-compiled / optimized / cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging / build
+build/
+dist/
+*.egg-info/
+.eggs/
+wheels/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+.env
+
+# Test / coverage / type-check caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# IDE / editor
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

anythink-0.1.0/CHANGELOG.md

@@ -0,0 +1,88 @@
+# Changelog
+
+All notable changes to Anythink are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.1.0] — 2026-06-19
+
+Initial release of Anythink — a universal, AI-powered CLI chatbot.
+
+### Added
+
+#### Core & Configuration
+- `AnythinkError` exception hierarchy: `ConfigError`, `ProviderError` (+ `AuthenticationError`, `RateLimitError`, `ProviderUnavailableError`, `ModelNotFoundError`), `SessionError`, `KeychainError`, `PluginError`, `SearchError`, `FileError`
+- `AppConfig` frozen dataclass with XDG Base Directory compliant storage
+- `ConfigManager` for loading/saving `config.yaml`; `Paths` helper resolving all XDG dirs
+- 4 built-in color themes: **Midnight** (default), **Aurora**, **Ember**, **Arctic**
+
+#### LLM Providers
+- `BaseProvider` ABC with `stream_chat`, `list_models`, `test_connection`, `supports_vision`, `requires_api_key`
+- Built-in providers: Groq, Google Gemini, OpenAI, Anthropic, Mistral, Cohere, Ollama, LM Studio
+- Optional extras: `pip install anythink[groq|gemini|openai|anthropic|mistral|cohere|all]`
+- Provider registry via Python `anythink.providers` entry points
+
+#### Terminal UI
+- ASCII logo startup banner (version, model alias, provider)
+- `StreamRenderer`: real-time token streaming with Rich markup
+- `ContextStatusBar`: live token usage bar with color thresholds (green → yellow → orange → red)
+- `make_console` / `make_prompt_session`: theme-aware terminal I/O
+
+#### Chat Loop
+- Interactive async chat loop with slash command dispatch and legacy `exit`/`quit` shortcuts
+- Persona / system prompt management: `/persona <name>|clear`
+- Approaching-context-limit warnings at 60 % / 85 % / 95 % thresholds
+
+#### API Key Management
+- OS keychain storage via `keyring` (macOS Keychain, Linux Secret Service, Windows Credential Manager)
+- YAML index file tracks configured providers (keyring has no list-by-service API)
+- CLI: `anythink keys add|show|update|delete|test <provider>`
+
+#### Model Aliases
+- `ModelAlias` + `ModelRegistry` backed by `models.yaml`
+- Friendly user-defined names for provider/model pairs with context-window sizes and vision flags
+- CLI: `anythink model add|list|remove`
+
+#### Session Management
+- `Session` + `SessionManager` with JSON-backed storage in `$XDG_DATA_HOME/anythink/sessions/`
+- Automatic session saving after each conversation (configurable via `session_autosave`)
+- Session search by name or ID prefix
+- `/session save|load|list|delete|rename` slash commands
+
+#### Slash Command System
+- `CommandRegistry` with entry-point discovery (`anythink.slash_commands`)
+- `CommandResult` pattern (`should_exit`, `message`, `error`) drives the chat loop
+- Built-in commands: `/help`, `/clear`, `/history`, `/tokens`, `/model`, `/persona`, `/session`, `/file`, `/image`, `/files`, `/search`, `/plugins`, `/exit`, `/quit`
+
+#### File Input & Multimodal Support
+- `TextAttachment` (≤ 1 MB, UTF-8): `.py`, `.js`, `.ts`, `.go`, `.rs`, `.json`, `.yaml`, `.md`, `.txt`, and 20+ more extensions
+- `ImageAttachment` (≤ 10 MB): PNG, JPEG, WEBP, GIF with automatic MIME-type mapping
+- `read_file()` auto-detects type by extension; `read_text_file()` / `read_image_file()` for explicit type
+- Multimodal messages: `TextPart` (file header + content) + `ImagePart` + `TextPart` (user text) via `ChatMessage.content: list[ContentPart]`
+- `ChatState.pending_attachments` cleared after each send
+
+#### Agentic Web Search
+- `BaseSearchBackend` ABC; `SearchResult` dataclass
+- `DuckDuckGoSearch`: free, lazy-imports `duckduckgo-search` (`pip install anythink[search]`)
+- `SerpAPISearch`: async `httpx` client, Google results via SerpAPI (requires key)
+- `SearchRegistry` with entry-point discovery and `get_available(preferred)` fallback
+- Auto-search mode: `/search on|off` injects results as `TextPart` before each user message
+- One-off search: `/search <query>` shows title / URL / snippet in terminal
+- `AppContext.search_registry` wired at startup (SerpAPI key looked up from keychain)
+
+#### Plugin Architecture
+- `PluginInfo` dataclass: name, version, description, author, entry_point_groups, homepage
+- `PluginManager.list_plugins()` discovers packages contributing to any `anythink.*` entry point group via distribution metadata
+- `PluginManager.install(pkg)` / `remove(pkg)` wrap `pip` via `subprocess`
+- `/plugins list|info|install|remove` slash commands
+- CLI: `anythink plugins list|info|install|remove`
+
+#### CI/CD
+- GitHub Actions `ci.yml`: lint (ruff), format check (black), type check (mypy), security scan (bandit), test matrix (Python 3.11 / 3.12 / 3.13), coverage XML upload, build + `twine check`
+- GitHub Actions `publish.yml`: tests → build → `twine check` → PyPI via OIDC trusted publishing (no stored secrets)
+- 80 % minimum test coverage enforced (`--cov-fail-under=80`)
+- 526 tests across 40+ test files
+
+[0.1.0]: https://github.com/dhineshtheprogrammer/anythink_ai/releases/tag/v0.1.0

anythink-0.1.0/CLAUDE.md

@@ -0,0 +1,110 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Anythink is a universal, AI-powered CLI chatbot (`pip install anythink`) built in Python 3.11+. It is currently at **early implementation stage** — only the CLI skeleton, config schema/manager, and exception hierarchy exist. The detailed feature spec lives in `anythink_app_description.md`.
+
+## Commands
+
+```bash
+# Install for development (editable, with all dev tools)
+pip install -e ".[dev]"
+
+# Run the CLI
+anythink
+anythink --version
+anythink keys list
+anythink model list
+
+# Lint
+ruff check src/
+
+# Format check (never auto-format in CI; use --check locally too)
+black --check src/ tests/
+
+# Type check (strict mypy, src/anythink only)
+mypy src/anythink
+
+# Security scan
+bandit -r src/anythink -c pyproject.toml
+
+# Tests (must set keyring backend to avoid OS keychain prompts)
+PYTHON_KEYRING_BACKEND=keyrings.alt.file.PlaintextKeyring pytest tests/ -v
+
+# Run a single test file
+PYTHON_KEYRING_BACKEND=keyrings.alt.file.PlaintextKeyring pytest tests/test_cli.py -v
+
+# Build PyPI distribution
+python -m build
+```
+
+Coverage minimum is 80% (enforced via `--cov-fail-under=80` in `pyproject.toml`). `src/anythink/ui/input.py` is excluded from coverage.
+
+## Architecture
+
+### Source layout
+
+```
+src/anythink/
+  __init__.py          # exposes __version__
+  cli.py               # Typer app — entry point (anythink command)
+  exceptions.py        # full exception hierarchy
+  config/
+    schema.py          # AppConfig frozen dataclass + VALID_THEMES
+    manager.py         # ConfigManager (load/save/validate) + Paths (XDG)
+```
+
+### Plugin system (entry points)
+
+New providers, search backends, and slash commands are registered via Python entry points in `pyproject.toml` — the core never changes to add capabilities:
+
+- `anythink.providers` → each provider class (e.g. `GroqProvider`)
+- `anythink.search_backends` → search backend classes
+- `anythink.slash_commands` → registration functions
+
+Provider SDKs are optional extras: `pip install anythink[groq]`, `[gemini]`, `[openai]`, `[anthropic]`, `[mistral]`, `[cohere]`, `[all]`.
+
+### Configuration & storage (XDG)
+
+All data follows XDG Base Directory Specification. Key paths are resolved in `config/manager.py:_resolve_paths()`:
+
+| File/Dir | Location |
+|---|---|
+| Main config | `$XDG_CONFIG_HOME/anythink/config.yaml` |
+| Model aliases | `$XDG_CONFIG_HOME/anythink/models.yaml` |
+| Personas | `$XDG_CONFIG_HOME/anythink/personas.yaml` |
+| Plugins | `$XDG_CONFIG_HOME/anythink/plugins.yaml` |
+| Sessions | `$XDG_DATA_HOME/anythink/sessions/` |
+| Logs | `$XDG_STATE_HOME/anythink/logs/` |
+
+Defaults without env vars: `~/.config/anythink/`, `~/.local/share/anythink/`, etc.
+
+`ConfigManager.is_configured()` checks for the existence of `config.yaml`. `ConfigManager.load()` returns an `AppConfig` frozen dataclass.
+
+### Exception hierarchy
+
+```
+AnythinkError
+  ConfigError
+  ProviderError
+    AuthenticationError
+    RateLimitError
+    ProviderUnavailableError
+    ModelNotFoundError
+  SessionError
+  KeychainError
+  PluginError
+  SearchError
+```
+
+`AnythinkError` carries both an internal `message` and a `user_message` (displayed in the terminal). `ProviderError` also carries the `provider` name.
+
+### CLI structure
+
+The Typer app in `cli.py` has two sub-apps: `keys_app` and `model_app`. The root callback (`main`) invokes `ConfigManager.is_configured()` before starting a chat session. All sub-commands beyond the initial skeleton are stubs referencing the implementation phase.
+
+### Testing conventions
+
+The `xdg_dirs` fixture in `tests/conftest.py` redirects all four XDG env vars to `tmp_path` subdirectories. Every test that touches the filesystem should use this fixture (or `config_manager` which builds on it) to avoid touching `~/.config`. The `PYTHON_KEYRING_BACKEND=keyrings.alt.file.PlaintextKeyring` env var must be set for any test that indirectly imports keyring code.

anythink-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to Anythink
+
+Thank you for your interest in contributing!
+
+## Development Setup
+
+```bash
+git clone https://github.com/dhineshtheprogrammer/anythink_ai
+cd anythink_ai
+pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+pytest tests/ -v
+```
+
+## Code Style
+
+- **Ruff** for linting: `ruff check src/`
+- **Black** for formatting: `black src/ tests/`
+- **Mypy** for type checking: `mypy src/anythink`
+
+## Submitting Changes
+
+1. Fork the repository
+2. Create a feature branch from `main`
+3. Make your changes with tests
+4. Ensure all CI checks pass
+5. Open a pull request
+
+## Plugin Development
+
+See the documentation on creating Anythink plugins (provider, search backend, slash command, file handler, or tool plugins) via Python entry points.

anythink-0.1.0/LICENSE

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