AIFT - AI-Friendly Tools

Command-line tools optimized for AI interaction. Simple, clear, context-aware.

Quick Start

With Docker (Recommended)

docker-compose up -d
docker-compose exec aift-os bash
aift test

Local Development

# Install dependencies
py -m pip install -e core web mcp-manager memo

# Test installation
aift --help
aift test

Available Tools

AIFT Core

aift info          # System information
aift debug         # Debug mode with system details
aift validate      # Validate configuration
aift test          # Run functionality tests
aift version       # Show version

Web Intelligence Suite

web search "query"
web scrape "https://url"
web api "https://api.url"

MCP Manager (AI-Friendly)

mcp-man ask "how to read a CSV?" # NLP Search ✨
mcp-man workflow run my-pipe      # Run Workflow ✨
mcp-man examples server tool      # AI Examples ✨
mcp-man export markdown           # LLM Export ✨
mcp-man history --failures        # Audit Trail

AI Features (Phase 3 Complete)

• ✅ Semantic Search: DuckDB-native vector search (MiniLM-L6-v2)
• ✅ NLP Engine: Natural language query parsing & intent matching
• ✅ Smart Workflows: Chain tools with intelligent recommendations
• ✅ Auto-Examples: Generates usage examples from tool schemas
• ✅ LLM Integration: Optimized prompt/doc exports for Claude & GPT

Project Structure

aift/
├── core/              # Core library (config, logging, CLI)
├── web/               # Web intelligence suite
├── mcp-manager/       # DuckDB MCP manager
├── memo/              # Memory & AI tools
├── docs/              # 📖 Documentation (see links below)
├── Dockerfile         # Docker image definition
├── docker-compose.yml # Complete stack
└── README.md          # This file

Documentation

Detailed guides in /docs:

• docs/Docker.md - Docker setup & commands
• docs/INSTALLATION.md - Local installation
• docs/ARCHITECTURE.md - Project structure & design
• docs/DEVELOPMENT.md - Development guide & contributing

Tool-specific docs:

• core/README.md - Core library
• web/README.md - Web tool
• mcp-manager/README.md - MCP manager
• tests/README_TESTS.md - Testing guide

AI/Copilot configuration:

• .github/copilot-instructions.md - Copilot instructions
• .github/AGENTS.md - Specialized Copilot agents

Docker Setup

What's Included

• Python 3.11 + all AIFT tools
• DuckDB 1.4.3, Ruff 0.14.13, MyPy 1.19.1
• CLI tools: rg, fd, bat, eza, yq, duckdb
• ML/AI libs: torch, transformers, sklearn, scipy
• SurrealDB + MCP services

Image Details

• Version: 2026-01
• Size: 1.04 GB
• Base: Python 3.11-slim-bookworm

Ports

• 8000 - AIFT services
• 8080 - Web interface
• 8888 - SurrealDB
• 9999 - MCP Manager

Volumes

aift-config  → /home/aift/.config      # Config
aift-logs    → /home/aift/aift/logs    # Logs
workspace    → /workspace/user         # Your data

Configuration

Environment variables (prefix: AIFT_):

AIFT_LOG_LEVEL=DEBUG      # Logging level
PYTHONUNBUFFERED=1        # Python output
CLAUDE_CODE_SANDBOX=true  # Sandbox mode

Config file: ~/.config/aift/config.env

Dependencies

Updated January 2026

Package	Version	Notes
pydantic	2.12.5	Data validation
typer	0.21.1	CLI framework
rich	14.2.0	Terminal UI
duckdb	1.4.3	Embedded SQL
ruff	0.14.13	Linting
mypy	1.19.1	Type checking
pytest	9.0.2	Testing

Development

Run Tests

aift test
pytest

Code Quality

ruff check src/
mypy src/

Build Docker Image

docker buildx build -t aift-os:latest . --load
docker-compose up -d

Commands Reference

CLI Aliases (enabled in container)

ls    → eza --icons                  # Modern listing
cat   → bat                          # Syntax highlighting
grep  → rg                           # Fast search
find  → fd                           # Fast find

Docker Commands

docker-compose up -d                 # Start services
docker-compose down                  # Stop services
docker-compose logs -f               # View logs
docker-compose exec aift-os bash     # Access shell

Troubleshooting

Container issues

docker-compose down -v
docker-compose up -d --build

Check health

docker-compose ps
docker-compose logs aift-os

Debug mode

AIFT_LOG_LEVEL=DEBUG aift test

More help in docs/Docker.md or docs/INSTALLATION.md.

License

See LICENSE file.

Getting Help

• 📖 Installation - Get started locally
• 🐳 Docker - Container setup
• 🏗️ Architecture - Project structure
• 👨‍💻 Development - Contributing guide
• 🧪 Testing - Run & write tests