gothos 0.2.0__tar.gz

gothos-0.2.0/.dockerignore

@@ -0,0 +1,10 @@
+.venv/
+__pycache__/
+*.pyc
+.git/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/

gothos-0.2.0/.github/workflows/gothos-ci.yml

@@ -0,0 +1,47 @@
+name: GothOS CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    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 dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check .
+
+      - name: Run tests
+        run: pytest -v
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Type check with mypy
+        run: mypy gothos --ignore-missing-imports

gothos-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,68 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify package
+        run: |
+          pip install dist/*.whl
+          python -c "import gothos; print(f'gothos {gothos.__version__}')"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

gothos-0.2.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+*.db
+.venv/
+venv/
+.env

gothos-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,19 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.6
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: check-merge-conflict
+      - id: debug-statements

gothos-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,71 @@
+# Contributing to gothos
+
+## Prerequisites
+
+- Python 3.12 or later
+- Git
+
+## Setup
+
+```bash
+git clone https://github.com/GouthamRajam/Accounting-erp-.git
+cd Accounting-erp-/gothos
+pip install -e ".[dev]"
+
+# Optional: install pre-commit hooks
+pip install pre-commit
+pre-commit install
+```
+
+## Running checks
+
+```bash
+# Tests
+pytest -v
+
+# Lint
+ruff check .
+
+# Type check (strict mode with pydantic plugin)
+mypy gothos --ignore-missing-imports
+```
+
+All three must pass before submitting a PR. CI runs them automatically
+on Python 3.12 and 3.13.
+
+## Code style
+
+- **Formatter**: ruff handles all formatting — no manual style decisions needed.
+- **Line length**: 100 characters.
+- **Type annotations**: required on all public APIs. The project uses `strict = true` mypy.
+- **Comments**: only when the *why* is non-obvious. Don't explain what the code does.
+- **Imports**: sorted by ruff (isort-compatible).
+
+## Making changes
+
+1. Branch from `main`.
+2. Write tests for new functionality or bug fixes.
+3. Run all three checks (tests, lint, types) locally.
+4. Open a PR targeting `main`.
+
+## Project structure
+
+```
+gothos/
+  core/         — LangGraph agent orchestrator (plan → execute → observe loop)
+  device/       — async ADB bridge, action executor, screenshot/UI capture
+  planner/      — LLM-based task decomposition into action steps
+  screen/       — UI hierarchy parsing, screen state analysis, diff
+  safety/       — action classification, confirmation gates, dialog handling
+  memory/       — SQLite-backed task/action/screen memory, navigation graphs
+  grounding/    — a11y-tree element finder, OCR fallback, provider-agnostic LLM grounding
+  extract/      — LLM-powered screen data extraction, MCP tool
+  llm/          — shared provider-agnostic LLM factory
+tests/          — mirrors module structure
+examples/       — integration demos
+```
+
+## License
+
+By contributing you agree that your contributions will be licensed under
+the Apache 2.0 License.

gothos-0.2.0/Dockerfile

@@ -0,0 +1,30 @@
+FROM python:3.12-slim
+
+LABEL maintainer="GouthamRajam"
+LABEL description="GothOS — provider-agnostic Android AI agent"
+
+# System dependencies
+RUN apt-get update -qq \
+    && apt-get install -y -qq --no-install-recommends \
+        android-tools-adb \
+        ffmpeg \
+        git \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install Python dependencies first (layer caching)
+COPY pyproject.toml ./
+RUN pip install --no-cache-dir --upgrade pip \
+    && pip install --no-cache-dir -e ".[dev]" || true
+
+# Copy source
+COPY . .
+RUN pip install --no-cache-dir -e .
+
+# Expose MCP server port (if running in HTTP mode)
+EXPOSE 8000
+
+# Default: start the MCP server
+ENTRYPOINT ["gothos"]
+CMD ["serve"]

gothos-0.2.0/LICENSE

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

gothos-0.2.0/Makefile

@@ -0,0 +1,33 @@
+.PHONY: install dev test lint typecheck fmt clean serve docker
+
+install:
+	pip install -e .
+
+dev:
+	pip install -e ".[dev]"
+
+test:
+	pytest -v
+
+lint:
+	ruff check .
+
+typecheck:
+	mypy gothos --ignore-missing-imports
+
+fmt:
+	ruff format .
+	ruff check --fix .
+
+clean:
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
+	rm -rf .pytest_cache .mypy_cache .ruff_cache dist build
+
+serve:
+	gothos serve
+
+docker:
+	docker build -t gothos .
+
+all: fmt lint typecheck test