Skip to main content

Aye: Terminal-first AI Code Generator

Project description

aye

Aye: AI‑powered coding assistant for the terminal

Aye is a terminal‑only AI assistant that:

  • generates code from natural‑language prompts,
  • automatically snapshots the target file before each change,
  • lets you list, view, and revert those snapshots (aye snap …),
  • uses a simple token‑based authentication model (no Cognito required).

Quick start

# Install from PyPI
pip install aye-cli

# Authenticate (you’ll get a token from your backend)
aye login

# One‑shot generation
aye generate "create a Python function that parses CSV" -f utils.py

# Interactive chat (optional)
aye chat -f utils.py

# Undo / snapshot utilities
aye snap list utils.py
aye snap show utils.py 20241012T153045
aye snap revert utils.py 20241012T153045

Development

# Clone the repo
git clone https://github.com/yourorg/aye.git
cd aye

# Create a virtual environment
python -m venv .venv && source .venv/bin/activate

# Install in editable mode with dev deps
pip install -e .[dev]

# Run the test suite
pytest -q

Packaging & distribution

# Build a wheel and source distribution
python -m build

# Install the wheel locally for a clean test
pip install dist/aye_cli-0.1.0-py3-none-any.whl

The console script aye will be available on the PATH.
License

MIT  see the LICENSE file (or the license header in pyproject.toml).
Contributing

Feel free to open issues or submit pull requests.
All contributions are welcome; just follow the usual GitHub workflow.

Project details


Release history Release notifications | RSS feed

This version

0.1.5

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ayechat-0.1.5.tar.gz (21.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ayechat-0.1.5-py3-none-any.whl (24.2 kB view details)

Uploaded Python 3

File details

Details for the file ayechat-0.1.5.tar.gz.

File metadata

  • Download URL: ayechat-0.1.5.tar.gz
  • Upload date:
  • Size: 21.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for ayechat-0.1.5.tar.gz
Algorithm Hash digest
SHA256 0c1f0f6cdcc95ca81a7d24e02f9978c539b54c440bfe8c250744514499fee296
MD5 1f06e7c994229965d8bfea6c1e6795c0
BLAKE2b-256 47d39f6c06734063b436eb64063e4448157333c8a596b80bb81934c2e90613df

See more details on using hashes here.

File details

Details for the file ayechat-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: ayechat-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 24.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for ayechat-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 5697cb097f70d81b5ceb0dc4af0013a6d58ff0784cedb3c9e31ab96941553639
MD5 ba367f51205a07bf530d009855ed667b
BLAKE2b-256 8ff2c8a6cd3d68b3f039cffac515ed96b95f3699fe98f8b1869bbf4a0040391d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page