Ath

Overview

Ath is an experimental AI-powered Python code assistant designed to help developers inspect, understand, and interact with their Python codebase through natural language.

The tool analyzes project structure using Python AST parsing and provides contextual assistance through an interactive CLI chat system.

Ath focuses on lightweight local analysis, project-wide context, and flexible AI provider integration.

Features

• AI-powered Python codebase analysis
• Interactive chat interface for code understanding
• Python AST-based project parsing
• Inspection of files, functions, classes, and imports
• Project-wide contextual understanding
• Support for OpenAI, Anthropic, and Ollama
• Lightweight SQLite-based storage
• CLI-driven workflow

Installation

Clone the repository and install the project locally.

git clone https://github.com/notsajeed/Ath.git
 cd Ath
 pip install -e .

Initialize the current Python project:

ath init --force

Usage

Ath provides commands for inspecting Python files and interacting with the codebase using AI chat.

ath inspect src/main.py
 ath chat

The assistant understands Python project structure, imports, classes, functions, and relationships between files.

AI Providers

Ath supports multiple AI providers and local models.

• OpenAI
• Anthropic Claude
• Ollama
• CodeLlama

Configuration is handled locally through the CLI.

Scope

• JavaScript and TypeScript support
• Java, Go, and Rust parsing
• Multi-language project support
• Git integration for change analysis
• Automatic documentation generation
• Code quality analysis

Development Notes

Ath started as an experiment exploring how AI systems can interact with real Python project structures through lightweight local tooling.

Current development focuses on improving contextual understanding, project indexing, and multi-provider compatibility.