PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.1.0

PyPI

aiexec

Run .ai natural-language automation scripts in a safe terminal loop.

Published7 Oct 2025
Direct dependencies3
Transitive dependenciesNot calculated

README

Version 0.1.0 documentation

aiexec

Run natural-language .ai automation scripts with a local, safe, agentic CLI loop.

Quick Install

MethodCommand
pipx (recommended)pipx install aiexec
pippython -m pip install aiexec
Sourcepip install -e . (from a cloned repo)

One-line bootstrap (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/your-org/aiexec/main/install/install-aiexec.sh | bash

One-line bootstrap (Windows PowerShell)

irm https://raw.githubusercontent.com/your-org/aiexec/main/install/install-aiexec.ps1 | iex

Usage

Run the provided example task:

aiexec run examples/setup_fastapi.ai --dry-run
  • --yes auto-confirms dangerous commands (e.g., rm -rf); omit to require confirmation.
  • --sandbox executes inside a temporary directory instead of your current working tree.
  • --verbose prints raw model responses.
  • --dry-run shows proposed commands without executing them.

Other helpful commands:

aiexec init my_task         # create my_task.ai template
aiexec list                 # list .ai files in the current directory
aiexec doctor               # check for Ollama/Hugging Face setup issues

Requirements

  • Python 3.10+
  • Ollama with the llama3:instruct model (ollama pull llama3:instruct)
  • Optional: HUGGINGFACE_API_TOKEN environment variable for Hugging Face models (--model hf:<repo>).

Development

Format and lint (optional):

pip install black ruff
black aiexec
ruff check aiexec

Run the unit-less sanity check:

python -m compileall aiexec

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 3

Native requirements
3 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
typer
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
typer>=0.12.3runtime
pyyaml
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pyyaml>=6.0.2runtime
rich
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
rich>=13.7.1runtime

Distribution files

2 collected
aiexec-0.1.0-py3-none-any.whl

bdist_wheel · 14.42 KB · Python py3

Source file
aiexec-0.1.0.tar.gz

sdist · 12.52 KB · Python source

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 21 Oct, 10:39 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:0fbc875ac92b97faed85f1a2b78e2a6e113461cfbefea84251265a58e041c814

Other collected versions

View all collected versions →