thrapai-aria 0.1.0__tar.gz

thrapai_aria-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

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

@@ -0,0 +1,44 @@
+name: Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint
+        run: uv run --extra dev ruff check
+
+      - name: Format check
+        run: uv run --extra dev ruff format --check
+
+      - name: Test
+        run: uv run --extra dev python -m pytest --cov=aria --cov-report=xml --cov-report=term
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.11'
+        uses: codecov/codecov-action@v5
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false

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

@@ -0,0 +1,29 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/thrapai-aria
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

thrapai_aria-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+.aria/
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+*.py[cod]
+.python-version
+.coverage
+coverage.xml
+dist/

thrapai_aria-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: uv run --extra dev ruff check
+        language: system
+        types: [python, yaml]
+      - id: ruff-format
+        name: ruff format
+        entry: uv run --extra dev ruff format --check
+        language: system
+        types: [python, yaml]
+      - id: pytest
+        name: pytest
+        entry: uv run --extra dev pytest
+        language: system
+        pass_filenames: false

thrapai_aria-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+Thanks for helping improve ARIA. Keep changes small, tested, and easy to review.
+
+The most useful contributions are new or improved extensions that let ARIA work with more tools, file types, providers, and workflow capabilities.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run --extra dev python -m pre_commit install
+uv run --extra dev python -m pytest
+uv run --extra dev ruff check
+uv run --extra dev ruff format --check
+```
+
+Run all hooks manually:
+
+```bash
+uv run --extra dev python -m pre_commit run --all-files
+```
+
+For document conversion work:
+
+```bash
+uv sync --extra dev --extra docling
+```
+
+## Pull Requests
+
+- Open an issue first for large behavior changes.
+- Add or update tests for runtime behavior.
+- Keep README changes focused on user-facing behavior.
+- Do not commit run artifacts, coverage output, or built distributions.

thrapai_aria-0.1.0/LICENSE

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

thrapai_aria-0.1.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: thrapai-aria
+Version: 0.1.0
+Summary: Automation Runtime for Intelligent Actions
+Project-URL: Homepage, https://github.com/thrapai/aria
+Project-URL: Repository, https://github.com/thrapai/aria
+Project-URL: Issues, https://github.com/thrapai/aria/issues
+Author-email: Thomas Rapai <th.rapai@hotmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,automation,cli,workflow,yaml
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Requires-Dist: jinja2
+Requires-Dist: openai
+Requires-Dist: pydantic
+Requires-Dist: pyyaml
+Requires-Dist: rich
+Requires-Dist: typer
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: docling
+Requires-Dist: docling; extra == 'docling'
+Description-Content-Type: text/markdown
+
+<h1 align="center">ARIA</h1>
+
+<p align="center">
+  Automation Runtime for Intelligent Actions.
+</p>
+
+<p align="center">
+  <img src="docs/logo.png" alt="ARIA logo" width="160">
+</p>
+
+<p align="center">
+  <a href="https://github.com/thrapai/aria/actions/workflows/ci.yml"><img alt="Tests" src="https://github.com/thrapai/aria/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://codecov.io/gh/thrapai/aria"><img alt="Coverage" src="https://codecov.io/gh/thrapai/aria/branch/main/graph/badge.svg"></a>
+  <a href="https://pypi.org/project/thrapai-aria/"><img alt="PyPI" src="https://img.shields.io/pypi/v/thrapai-aria.svg"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
+</p>
+
+Build AI-powered workflows with ARIA.
+
+Your workflows are source-controlled, CI-friendly, and live in YAML files. Define them, run them locally, and inspect every result from saved run artifacts.
+
+## Why ARIA?
+
+- Source-controlled workflows: prompts, steps, inputs, and providers live in YAML.
+- Full step transparency: see every intermediate result, not just the final answer.
+- Extensible runtime: add your own extension when a built-in step is not enough.
+- Provider flexibility: OpenAI and local Ollama today, with more providers to come.
+- Small runtime: no hosted service, web UI, marketplace, or agent framework.
+
+## Install
+
+With the install script:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/thrapai/aria/master/install.sh | bash
+```
+
+With optional docling support:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/thrapai/aria/master/install.sh | ARIA_PACKAGE='thrapai-aria[docling]' bash
+```
+
+With `pipx`:
+
+```bash
+pipx install thrapai-aria
+```
+
+For docling support:
+
+```bash
+pipx install "thrapai-aria[docling]"
+```
+
+## Quickstart
+
+Create a workflow:
+
+```bash
+aria init
+```
+
+Run it:
+
+```bash
+ollama pull gemma3:4b
+aria run workflow.yml --input path=notes.txt
+```
+
+ARIA prints final outputs as JSON and writes run artifacts under `.aria/runs/<timestamp>/`.
+
+## Workflow
+
+```yaml
+version: "1"
+name: summarize_file
+
+providers:
+  ollama:
+    type: ollama
+    base_url: http://localhost:11434
+
+inputs:
+  path:
+    type: file
+    required: true
+
+steps:
+  - id: read
+    uses: file.read
+    with:
+      path: "{{ inputs.path }}"
+
+  - id: summarize
+    uses: ai.generate
+    with:
+      model: ollama:gemma3:4b
+      prompt: |
+        Summarize this file in five concise bullet points:
+
+        {{ steps.read.output.content }}
+
+  - id: save
+    uses: file.write
+    with:
+      path: summary.txt
+      content: "{{ steps.summarize.output.text }}"
+
+outputs:
+  summary: "{{ steps.summarize.output.text }}"
+  summary_file: "{{ steps.save.output.path }}"
+```
+
+Templates can read workflow inputs and previous step outputs:
+
+```jinja2
+{{ inputs.path }}
+{{ steps.read.output.content }}
+```
+
+## Built-In Extensions
+
+- `ai.generate`
+- `file.read`
+- `file.write`
+- `utils.json.parse`
+- `utils.text.chunk`
+- `docling.convert` - _optional_
+
+Extension examples live in `docs/extensions/`.
+
+## Providers
+
+ARIA currently supports `openai` and `ollama` provider types. A provider entry is an
+alias that can be used in `ai.generate` model strings as `provider:model`.
+
+### OpenAI
+
+```bash
+export OPENAI_API_KEY="..."
+```
+
+```yaml
+providers:
+  openai:
+    type: openai
+    api_key_env: OPENAI_API_KEY
+    # Optional:
+    # api_key_file: .openai-key
+    # base_url: https://api.openai.com/v1
+```
+
+If no `providers.openai` entry is configured, `openai:<model>` still works and
+reads `OPENAI_API_KEY` from the environment.
+
+### Ollama
+
+```bash
+ollama pull gemma3:4b
+```
+
+```yaml
+providers:
+  ollama:
+    type: ollama
+    base_url: http://localhost:11434
+```
+
+If no `providers.ollama` entry is configured, `ollama:<model>` still works and
+uses `http://localhost:11434`.
+
+Provider names may be custom aliases when the entry declares a supported `type`:
+
+```yaml
+providers:
+  local:
+    type: ollama
+    base_url: http://localhost:11434
+
+steps:
+  - id: summarize
+    uses: ai.generate
+    with:
+      model: local:gemma3:4b
+      prompt: "Summarize: {{ inputs.text }}"
+```
+
+Use providers as `provider:model`, for example `openai:gpt-4.1-mini`,
+`ollama:gemma3:4b`, or `local:gemma3:4b`.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run --extra dev python -m pytest
+uv run --extra dev ruff check
+uv run --extra dev ruff format --check
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution and release notes.
+
+## License
+
+MIT

thrapai_aria-0.1.0/README.md

@@ -0,0 +1,205 @@
+<h1 align="center">ARIA</h1>
+
+<p align="center">
+  Automation Runtime for Intelligent Actions.
+</p>
+
+<p align="center">
+  <img src="docs/logo.png" alt="ARIA logo" width="160">
+</p>
+
+<p align="center">
+  <a href="https://github.com/thrapai/aria/actions/workflows/ci.yml"><img alt="Tests" src="https://github.com/thrapai/aria/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://codecov.io/gh/thrapai/aria"><img alt="Coverage" src="https://codecov.io/gh/thrapai/aria/branch/main/graph/badge.svg"></a>
+  <a href="https://pypi.org/project/thrapai-aria/"><img alt="PyPI" src="https://img.shields.io/pypi/v/thrapai-aria.svg"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
+</p>
+
+Build AI-powered workflows with ARIA.
+
+Your workflows are source-controlled, CI-friendly, and live in YAML files. Define them, run them locally, and inspect every result from saved run artifacts.
+
+## Why ARIA?
+
+- Source-controlled workflows: prompts, steps, inputs, and providers live in YAML.
+- Full step transparency: see every intermediate result, not just the final answer.
+- Extensible runtime: add your own extension when a built-in step is not enough.
+- Provider flexibility: OpenAI and local Ollama today, with more providers to come.
+- Small runtime: no hosted service, web UI, marketplace, or agent framework.
+
+## Install
+
+With the install script:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/thrapai/aria/master/install.sh | bash
+```
+
+With optional docling support:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/thrapai/aria/master/install.sh | ARIA_PACKAGE='thrapai-aria[docling]' bash
+```
+
+With `pipx`:
+
+```bash
+pipx install thrapai-aria
+```
+
+For docling support:
+
+```bash
+pipx install "thrapai-aria[docling]"
+```
+
+## Quickstart
+
+Create a workflow:
+
+```bash
+aria init
+```
+
+Run it:
+
+```bash
+ollama pull gemma3:4b
+aria run workflow.yml --input path=notes.txt
+```
+
+ARIA prints final outputs as JSON and writes run artifacts under `.aria/runs/<timestamp>/`.
+
+## Workflow
+
+```yaml
+version: "1"
+name: summarize_file
+
+providers:
+  ollama:
+    type: ollama
+    base_url: http://localhost:11434
+
+inputs:
+  path:
+    type: file
+    required: true
+
+steps:
+  - id: read
+    uses: file.read
+    with:
+      path: "{{ inputs.path }}"
+
+  - id: summarize
+    uses: ai.generate
+    with:
+      model: ollama:gemma3:4b
+      prompt: |
+        Summarize this file in five concise bullet points:
+
+        {{ steps.read.output.content }}
+
+  - id: save
+    uses: file.write
+    with:
+      path: summary.txt
+      content: "{{ steps.summarize.output.text }}"
+
+outputs:
+  summary: "{{ steps.summarize.output.text }}"
+  summary_file: "{{ steps.save.output.path }}"
+```
+
+Templates can read workflow inputs and previous step outputs:
+
+```jinja2
+{{ inputs.path }}
+{{ steps.read.output.content }}
+```
+
+## Built-In Extensions
+
+- `ai.generate`
+- `file.read`
+- `file.write`
+- `utils.json.parse`
+- `utils.text.chunk`
+- `docling.convert` - _optional_
+
+Extension examples live in `docs/extensions/`.
+
+## Providers
+
+ARIA currently supports `openai` and `ollama` provider types. A provider entry is an
+alias that can be used in `ai.generate` model strings as `provider:model`.
+
+### OpenAI
+
+```bash
+export OPENAI_API_KEY="..."
+```
+
+```yaml
+providers:
+  openai:
+    type: openai
+    api_key_env: OPENAI_API_KEY
+    # Optional:
+    # api_key_file: .openai-key
+    # base_url: https://api.openai.com/v1
+```
+
+If no `providers.openai` entry is configured, `openai:<model>` still works and
+reads `OPENAI_API_KEY` from the environment.
+
+### Ollama
+
+```bash
+ollama pull gemma3:4b
+```
+
+```yaml
+providers:
+  ollama:
+    type: ollama
+    base_url: http://localhost:11434
+```
+
+If no `providers.ollama` entry is configured, `ollama:<model>` still works and
+uses `http://localhost:11434`.
+
+Provider names may be custom aliases when the entry declares a supported `type`:
+
+```yaml
+providers:
+  local:
+    type: ollama
+    base_url: http://localhost:11434
+
+steps:
+  - id: summarize
+    uses: ai.generate
+    with:
+      model: local:gemma3:4b
+      prompt: "Summarize: {{ inputs.text }}"
+```
+
+Use providers as `provider:model`, for example `openai:gpt-4.1-mini`,
+`ollama:gemma3:4b`, or `local:gemma3:4b`.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run --extra dev python -m pytest
+uv run --extra dev ruff check
+uv run --extra dev ruff format --check
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution and release notes.
+
+## License
+
+MIT

thrapai_aria-0.1.0/docs/extensions/ai.md

@@ -0,0 +1,42 @@
+# ai
+
+AI generation extensions.
+
+## ai.generate
+
+Input:
+
+```yaml
+model: ollama:gemma3:4b
+prompt: "Summarize: {{ inputs.text }}"
+```
+
+`model` must use `provider:model` format. The provider can be a built-in
+provider name, such as `openai` or `ollama`, or a custom alias from the
+workflow's `providers` block.
+
+Supported provider types:
+
+- `openai` - reads `OPENAI_API_KEY` by default, or `api_key_env` /
+  `api_key_file` from the provider config. `base_url` is optional.
+- `ollama` - uses `http://localhost:11434` by default. `base_url` is optional.
+
+Output:
+
+```json
+{
+  "text": "...",
+  "model": "ollama:gemma3:4b"
+}
+```
+
+Example:
+
+```yaml
+steps:
+  - id: summarize
+    uses: ai.generate
+    with:
+      model: ollama:gemma3:4b
+      prompt: "Summarize: {{ inputs.text }}"
+```