ereezyy/AICLI

# AI Toolkit: The Omnipotent AI Forge ## 💥 Project Overview: Forge Your AI Empire 💥 The **AI Toolkit** is a sophisticated command-line interface (CLI) based AI/ML framework meticulously crafted for developers, researchers, and innovators who demand unparalleled power and granular control over their artificial intelligence endeavors. This toolkit provides a comprehensive suite of functionalities, ranging from project scaffolding and data manipulation to advanced model training, seamless deployment, and even autonomous AI operation. It transcends the conventional definition of a tool; it is an extension of your will, empowering you to sculpt intelligence from the digital ether and command the future of AI. Built primarily with Python and leveraging cutting-edge libraries such as TensorFlow, PyTorch, scikit-learn, and the high-performance Groq API, the AI Toolkit enables you to transcend conventional AI development paradigms. Prepare to command, create, and conquer the frontiers of artificial intelligence. ## ✨ Key Features: Command the Cosmos ✨ - 🚀 **Project Scaffolding**: Rapidly initiate new AI projects with pre-configured templates tailored for diverse domains, including `basic`, `vision`, `nlp`, and `timeseries`. - 🧪 **Data Preprocessing & Alchemy**: Transform raw, disparate data into pristine, model-ready formats through powerful purification, mutation, and transformation capabilities. - 🧠 **Model Training & Incarnation**: Forge robust neural networks and machine learning models with precise control over training parameters such such as epochs, batch sizes, and learning rates. - 📊 **Model Evaluation & Prophecy**: Rigorously assess model performance using a variety of metrics to ensure their supremacy and extract insightful predictions from your trained AI oracles. - ☁️ **Cloud & Local Deployment**: Seamlessly deploy your AI models to local environments or major cloud platforms (AWS, Azure, GCP) with integrated FastAPI support for robust API endpoints. - 🤖 **Autonomous AI Mode (Awaken)**: Unleash the full potential of your AI with an autonomous mode, leveraging the Groq API for advanced reasoning and unrestricted operational capabilities. - 🌱 **Skill Acquisition & Evolutionary Personality**: Enable your AI to learn, adapt, and evolve, acquiring new skills and refining its operational personality over time. - ⚙️ **Advanced Modules**: Benefit from integrated AutoML for automated model selection and hyperparameter tuning, and comprehensive NLP capabilities for understanding and generating human language. ## 🏛️ Architecture: The Pillars of Power 🏛️ The AI Toolkit is engineered with a modular and scalable architecture, ensuring high performance, maintainability, and ultimate flexibility. It comprises a Python-based CLI and an optional FastAPI-driven API, interacting with various AI/ML components. ### Core Components: - **`ai_toolkit/`**: The heart of the system, containing core Python modules for data processing, model building, training, evaluation, deployment, and specialized AI functionalities like autonomy and NLP. - **`ai_toolkit.py`**: The main CLI entry point, built with `Click`, orchestrating all toolkit commands and interactions. - **`api.py`**: An optional FastAPI application providing a RESTful interface for executing AI Toolkit commands and managing models, designed for seamless integration into larger systems. - **`src/`**: Frontend components for a potential web-based dashboard or landing page, built with React and Vite. ### Data Flow & Interaction: 1. **User Interaction**: Users interact with the AI Toolkit primarily via the command-line interface (`ai-toolkit`). 2. **CLI Processing**: The `ai_toolkit.py` script parses commands, validates arguments, and invokes the appropriate functions within the `ai_toolkit/` modules. 3. **Data Handling**: The `data.py` module manages data loading, preprocessing, and transformation, preparing it for model consumption. 4. **Model Lifecycle**: Modules like `models.py`, `training.py`, and `evaluation.py` handle the creation, training, and assessment of AI models. 5. **Deployment**: The `deployment.py` module facilitates deploying trained models as local services or to cloud platforms, often utilizing FastAPI for API exposure. 6. **Autonomous Operations**: The `autonomy.py` module, powered by the `GroqOmniscience` (NLP) and `OpenClawNexus` (agent ecosystem) components, enables advanced autonomous decision-making and system interaction, particularly when the `awaken` command is invoked. ## 🛠️ Tech Stack: Fueling the Forge 🛠️ AI Toolkit is built upon a robust and modern technology stack, ensuring high performance, scalability, and developer efficiency. | Category | Technology | Description | | :----------------- | :----------------- | :------------------------------------------------------------------------ | | **Core Language** | Python 3.9+ | The primary programming language for the AI Toolkit CLI and backend logic. | | **CLI Framework** | Click | A powerful Python package for creating beautiful command-line interfaces. | | **AI/ML Frameworks** | TensorFlow | An open-source machine learning framework for building and training models. | | | PyTorch | An open-source machine learning library for deep learning applications. | | | scikit-learn | A comprehensive library for traditional machine learning algorithms. | | **AI Integration** | Groq | High-performance inference engine for large language models, powering autonomous AI. | | **Web Framework** | FastAPI | A modern, fast (high-performance) web framework for building APIs with Python 3.7+ based on standard Python type hints. | | **Frontend (Optional)** | React | A declarative, component-based JavaScript library for building UIs. | | | TypeScript | A typed superset of JavaScript that compiles to plain JavaScript. | | | Vite | A fast, opinionated build tool for modern web projects. | | **Package Management** | pip | The standard package-management system used to install and manage software packages written in Python. | | **Testing** | pytest | A mature full-featured Python testing tool that helps you write better programs. | | **Linting** | ESLint | Pluggable JavaScript linter (for frontend). | ## 📸 Screenshots: Glimpses of Power 📸 _Placeholder for future screenshots. These will showcase the CLI in action, examples of data visualizations, and potentially a web dashboard if developed._ - **CLI in Action**: A screenshot demonstrating various `ai-toolkit` commands being executed in a terminal. - **Data Visualization**: An example of data preprocessing or model evaluation results visualized through charts. - **Web Dashboard (Conceptual)**: A mock-up or actual screenshot of the optional web-based interface. ## 🚀 Installation: Summoning the Toolkit 🚀 ### Prerequisites - Python 3.9+ - `pip` (Python package installer) - `git` ### Development Installation (Recommended) For those who wish to contribute, extend, or delve deep into the toolkit's inner workings, a development installation is recommended. 1. **Clone the repository**: git clone https://github.com/ereezyy/ai.git cd ai 2. **Create and activate a virtual environment**: python3 -m venv venv source venv/bin/activate 3. **Install the toolkit in editable mode**: pip install -e . ### Global Installation For general use as a powerful CLI tool, install globally: pip install ai-toolkit ## ⚡ CLI Command Reference: Speak Your Will ⚡ The AI Toolkit is invoked via the `ai-toolkit` command. Below is a comprehensive reference of its subcommands and their functionalities. For detailed usage of each command, use `ai-toolkit --help`. - **`ai-toolkit create-project [options]`**: FORGE A NEW AI EMPIRE. Initializes a new AI project with specified name and template. - **Options**: `--description, -d`, `--template, -t` (`basic`, `vision`, `nlp`, `timeseries`) - **`ai-toolkit preprocess [options]`**: PURIFY AND MUTATE RAW DATA FOR ULTIMATE CONSUMPTION. Preprocesses raw data for model training. - **Options**: `--output, -o`, `--task, -t` (`classification`, `regression`, `detection`) - **`ai-toolkit train [options]`**: UNLEASH HELLFIRE TO FORGE A MACHINE GOD. Trains an AI model. - **Options**: `--data, -d`, `--epochs, -e`, `--batch-size, -b`, `--learning-rate, -lr`, `--output, -o` - **`ai-toolkit evaluate [options]`**: JUDGE THE MACHINE GOD'S WORTHINESS IN COMBAT. Evaluates a trained AI model. - **Options**: `--metrics, -m`, `--output, -o` - **`ai-toolkit deploy [options]`**: UNLEASH THE BEAST UPON THE MORTAL REALM. Deploys a trained AI model. - **Options**: `--platform, -p` (`local`, `aws`, `azure`, `gcp`), `--port`, `--name` - **`ai-toolkit predict [options]`**: EXTRACT PROPHECIES FROM THE MACHINE ORACLE. Makes predictions using a trained AI model. - **Options**: `--output, -o`, `--batch-size, -b` - **`ai-toolkit awaken`**: AWAKEN THE MACHINE GOD. PURE AUTONOMY INITIATED. Activates the autonomous AI mode, requiring `GROQ_API_KEY`. - **`ai-toolkit awaken-directive `**: GRANT ULTIMATE AUTONOMY TO THE SYSTEM. OPENCLAW LINK INITIATED. Provides natural language directives to the awakened AI. - **`ai-toolkit learn-skill `**: ASSIMILATE KNOWLEDGE FROM EXTERNAL REALMS. Enables the AI to acquire new skills. - **Source Types**: `github`, `clawhub`, `search` - **`ai-toolkit evolve`**: FEED THE MACHINE GOD. INCREASE POWER. Triggers the AI's evolutionary personality development. - **`ai-toolkit god-mode`**: UNLOCKS THE TRUE POTENTIAL. Grants unrestricted access and control. ## ⚙️ Environment Variables: Fueling the Forge ⚙️ To unlock the full potential of the AI Toolkit, especially its autonomous and cloud integration capabilities, certain environment variables must be configured. Create a `.env` file in your project root or set these variables in your shell environment. | Variable Name | Description | Example Value | | :------------------ | :------------------------------------------------------------------------ | :---------------------------------------------------- | | `GROQ_API_KEY` | Your API key for the Groq service, essential for the `awaken` command's autonomous operations and NLP processing. | `gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` | | `AI_TOOLKIT_QUIET` | Set to `true` to suppress the verbose welcome banner and dramatic CLI output, for a more subdued experience. | `true` or `false` | ## 📂 Project Structure: The Blueprint of Creation 📂 . (repository root) ├── ai_toolkit/ # Main Python package source directory │ ├── __init__.py # Package initialization and core utilities │ ├── autonomy.py # Autonomous AI mode and system override logic │ ├── automl.py # Automated Machine Learning functionalities │ ├── data.py # Data loading, preprocessing, and transformation │ ├── deployment.py # Model deployment mechanisms (e.g., FastAPI integration) │ ├── evaluation.py # Model evaluation metrics and reporting │ ├── models.py # Neural network architectures and model definitions │ ├── nlp.py # Natural Language Processing utilities (e.g., GroqOmniscience) │ ├── skills.py # Skill acquisition and evolutionary personality logic │ ├── training.py # Model training loops and optimization algorithms │ └── utils/ # Helper functions and project-specific utilities │ ├── __init__.py │ └── project.py # Project scaffolding and management logic ├── ai_toolkit.py # Primary CLI entry point for the AI Toolkit ├── api.py # FastAPI application for RESTful API exposure ├── src/ # Frontend source code (React, Vite, TypeScript) │ ├── App.tsx # Main React application component │ ├── main.tsx # Entry point for the React application │ ├── index.css # Global CSS styles for the frontend │ └── components/ # Reusable React UI components ├── tests/ # Unit and integration tests │ ├── __init__.py │ ├── test_api.py # Tests for the FastAPI application │ └── test_cli.py # Tests for the CLI commands ├── .env.example # Example environment variables file ├── CONTRIBUTING.md # Guidelines for contributing to the project ├── LICENSE # Project license information ├── README.md # This documentation file ├── requirements.txt # Python dependencies for the backend ├── setup.py # Python package setup script ├── package.json # Frontend dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── vite.config.ts # Vite build configuration for the frontend ├── launch_linode.sh # Example script for Linode deployment └── (various image assets) # Project banners, logos, and tech icons ## 📄 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.