ainator 0.0.3

No project description provided

Ainator

Ainator is a command-line interface (CLI) and API framework for running powerful AI agents. Built on top of the agno agent library, it provides persistent session management, Retrieval-Augmented Generation (RAG) over code repositories and websites, integrated tools (shell, files, DuckDuckGo search), knowledge plugins, and a FastAPI web server.

Perfect for developers seeking a local, configurable AI assistant for coding, debugging, documentation querying, and more.

Features

• Interactive Chat: Real-time terminal conversations with streaming responses and tool usage visualization.
• Persistent Sessions: Auto-saved conversations with switchable contexts and auto-generated names.
• Knowledge Bases (RAG):
  • Embed code repositories (AST-aware chunking, parallel processing, LanceDB storage).
  • Embed websites (scraping with Parsel + chunking).
  • Query with search, think, analyze tools.
• Built-in Tools:
  • Chunked shell execution for safety.
  • File read/write operations.
  • DuckDuckGo search.
  • Custom knowledge tools.
• Configurable: YAML config for models (e.g., xAI Grok, OpenAI), DB, tools, knowledge.
• Web API: FastAPI server for programmatic agent access.
• Plugin System: Extensible RAG knowledge via entry points (ainator.knowledge).

Installation

pip install ainator

Requirements: Python ≥3.8. Dependencies: agno, ddgs, chunkie, parsel.

Runs in any directory; creates .ainator/config.yml on first use.

Quickstart

1. Interactive Chat

ainator chat

Start a persistent chat session (default model: xAI Grok). Supports streaming, tools, history.

2. One-off Prompts

ainator prompt "Fix the bug in my Python script"

Creates/saves a new session. Continue in same session:

ainator but "Also add unit tests"

3. Session Management

ainator session list    # List sessions (ID, date, name)
ainator session switch <id>  # Switch to session
ainator session show    # Show messages in current session

4. Manage Knowledge (RAG)

Add code repo (embeds with code-aware splitting):

ainator rag code add ./path/to/repo python  # language=python, num_workers=12

Adds to config as knowledge.<repo-name>.

Add website (similar via rag site add <url>).

ainator rag site add https://cli2.readthedocs.io

Adds to config as knowledge.<domain-slug-url-slug>.

Search knowledge:

ainator rag search <knowledge-name> "your query"

Remove knowledge:

ainator rag remove <knowledge-name>

View RAGs:

ainator rag

5. Web Server

ainator server

• Agno-AGI Open Source Web UI available
• Swagger docs at http://localhost:7777/docs (Powered by the glorious Agno AgentOS)

Config Inspection

ainator # help

Shows current session (if any) and full config.

Configuration Hacking

Local .ainator/config.yml, auto-created/updated, but can be hacked manually for hacking purposes:

model: agno.models.xai:xAI id=grok-beta  # Or openai:gpt-4o, etc.
db: agno.db.sqlite:SqliteDb db_file=.ainator/agno.db
tools:
  - agno.tools.file:FileTools base_dir=.
  - agno.tools.shell:ShellTools
  - agno.tools.duckduckgo:DuckDuckGoTools
knowledge: {}  # Populated via CLI, e.g.:
#   myrepo:
#     plugin: code
#     path: /path/to/repo

The format is dotted.path.to.module:ClassName arg0 argN kwarg0=value0 to customize Agno framework object casting, so, you can extend the solution with your own python code right there in the config, for hacking purpose of course.

Architecture

• Core: agno (agents, models, tools, SQLite DB).
• CLI: cli2 CLI framework.
• Knowledge Plugins:

  Plugin	Description
  code	Faster repos embeds (llama-index CodeSplitter, HierarchicalNodeParser, BAAI/bge-small-en-v1.5 embeddings, LanceDB).
  site	Faster Website scraping & embedding (Parsel + Chunkie).
  generic	Feed local directories to Agno Knowledge directly.

• Renderer: Streaming Markdown with reasoning/tool steps.
• Server: FastAPI via agno AgentOS.

Development

git clone <repo-url>  # e.g., https://yourlabs.io/oss/ainator
cd ainator
pip install -e '.[types]'  # editable + mypy

• Type check: hatch run types:check (or mypy src/ainator)
• Coverage: Configured for ainator, tests.
• Version: Managed via src/ainator/__about__.py (currently 0.0.1).
• Plugins: Add via [project.entry-points."ainator.knowledge"].

No tests yet; contribute!

License

MIT © 2026-present jpic

See LICENSE.txt.

Links

• PyPI
• Source
• Issues
• Agno (core lib)