Metadata-Version: 2.4
Name: aiforge-engine
Version: 0.0.6
Summary: Intelligent Intent Adaptive Execution Engine - 智能意图自适应执行引擎
Project-URL: Homepage, https://github.com/iniwap/AIForge
Project-URL: Documentation, https://iniwap.github.io/AIForge
Project-URL: Repository, https://github.com/iniwap/AIForge
Project-URL: Bug Tracker, https://github.com/iniwap/AIForge/issues
Project-URL: Changelog, https://github.com/iniwap/AIForge/releases
Project-URL: Source Code, https://github.com/iniwap/AIForge
Project-URL: Discord, https://discord.gg/Vp35uSBsrw
Project-URL: Twitter, https://twitter.com/iafun_tipixel
Author-email: iniwap <iniwaper@gmail.com>
Maintainer-email: iniwap <iniwaper@gmail.com>
License: Apache 2.0
License-File: LICENSE
Keywords: agent,ai,ai-agents,ai-tools,aipyapp,automation,code-generation,crewai,engine,execution,intent,llm,manus,natural-language,search
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.9.0
Requires-Dist: click>=8.0.0
Requires-Dist: peewee>=3.14.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.25.0
Requires-Dist: tomlkit>=0.10.0
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: all
Requires-Dist: fastapi>=0.100.0; extra == 'all'
Requires-Dist: sentence-transformers>=2.0.0; extra == 'all'
Requires-Dist: textual>=0.40.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: python-dotenv>=1.0.0; extra == 'dev'
Provides-Extra: gui
Requires-Dist: textual>=0.40.0; extra == 'gui'
Provides-Extra: transformers
Requires-Dist: sentence-transformers>=2.0.0; extra == 'transformers'
Provides-Extra: web
Requires-Dist: fastapi>=0.100.0; extra == 'web'
Requires-Dist: uvicorn>=0.20.0; extra == 'web'
Description-Content-Type: text/markdown

# 🚀 AIForge - Intelligent Intent Adaptive Execution Engine  
  
<div align="center">  
  
[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) [![Textual](https://img.shields.io/badge/Textual-4.0.0+%20-purple)](https://textual.textualize.io/) [![FastAPI](https://img.shields.io/badge/FastAPI-0.116.1+%20-red)](https://fastapi.tiangolo.com/) [![SentenceTransformers](https://img.shields.io/badge/SentenceTransformers-5.0.0+%20-pink)](https://www.SBERT.net/)  
[![PyPI version](https://badge.fury.io/py/aiforge-engine.svg)](https://badge.fury.io/py/aiforge-engine) [![Downloads](https://pepy.tech/badge/aiforge-engine)](https://pepy.tech/project/aiforge-engine) [![AI Powered](https://img.shields.io/badge/AI-Powered-ff69b4.svg)](#) [![License](https://img.shields.io/badge/license-Apache%202.0-yellow)](./LICENSE) [![Stars](https://img.shields.io/github/stars/iniwap/AIForge?style=social)](https://github.com/iniwap/AIForge)  
[![Development Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/iniwap/AIForge) [![Development Status](https://img.shields.io/badge/development-active-brightgreen.svg)](https://github.com/iniwap/AIForge)  
  
**Transform natural language instructions into executable code with AI-powered automation**  
  
[🚀 Quick Start](#basic-usage) • [🧠 Core Features](#-core-features) • [⚡ Installation](#installation) • [🌐 Ecosystem](#-connect--support)  
  
</div>  
  
---  
  
## 🎯 What is AIForge?  
  
> ⚠️ **Development Status**: This project is currently in active development (Alpha v0.0.5). APIs may change frequently as we iterate and improve.  
  
> 🚧 **Project Status**: Actively developed, feedback and contributions welcome!  

  ![LOGO](https://raw.githubusercontent.com/iniwap/AIForge/main/logo.jpg)  
AIForge is an **intelligent execution engine** that bridges the gap between natural language instructions and code execution. Through advanced instruction analysis and adaptive execution architecture, AIForge provides:  
  
- 🧠 **Deep Understanding** - Multi-dimensional instruction parsing with precise intent capture  
- ⚡ **Instant Execution** - Rapid code generation with real-time environment interaction    
- 🔮 **Smart Caching** - Semantic similarity-based intelligent code reuse  
- 🌊 **Self-Evolution** - Continuous learning optimization with error self-healing  
- 🎭 **Multi-Provider** - Seamless switching between AI models and providers  
  
## ✨ Core Features  
  
### 🏗️ Multi-Interface Architecture  
- **CLI Interface** - Command-line tool for direct execution  
- **Python API** - Programmatic integration for applications  
- **Web API** - FastAPI-based REST interface  
- **Terminal GUI** - Interactive text-based user interface  
  
### 🤖 LLM Provider Support  
- **OpenAI** - GPT models integration  
- **DeepSeek** - Cost-effective AI provider  
- **OpenRouter** - Multi-model access platform  
- **Ollama** - Local model execution  
  
### 🔧 Advanced Execution Management  
- **Semantic Caching** - Intelligent code reuse based on instruction similarity  
- **Template System** - Domain-specific execution templates  
- **Search Integration** - Multi-engine search capabilities (Baidu, Bing, 360, Sogou)  
- **Content Generation** - Specialized content creation workflows  
  
### 🛡️ Enterprise-Ready Features  
- **Sandboxed Execution** - Secure isolated code execution environment  
- **Progress Tracking** - Real-time execution status indicators  
- **Error Handling** - Comprehensive exception management and retry logic  
- **Configuration Management** - Flexible TOML-based configuration system  
  
## 🚀 Quick Start  
  
### Installation  
  
    # Basic installation  
    pip install aiforge-engine  
  
    # With optional dependencies  
    pip install aiforge-engine[all]  # All features  
    pip install aiforge-engine[gui]  # Terminal GUI support  
    pip install aiforge-engine[web]  # Web API support  
  
### Basic Usage  
  
    from aiforge import AIForgeEngine  
  
    # Quick start with API key  
    forge = AIForgeEngine(api_key="your-api-key")  
  
    # Execute natural language instruction  
    result = forge("Analyze global stock market trends and generate investment recommendations")  
    print(result)  
  
### Advanced Configuration  
  
    # Provider-specific configuration  
    forge = AIForgeEngine(  
        api_key="your-deepseek-key",  
        provider="deepseek",  
        max_rounds=5,  
        cache_enabled=True  
    )  
  
    # Complex task execution  
    result = forge.run(  
        "Build a real-time data monitoring system",  
        system_prompt="You are a senior software architect"  
    )  
  
### Configuration File Setup  
  
    # aiforge.toml  
    workdir = "aiforge_work"  
    max_tokens = 4096  
    max_rounds = 5  
    default_llm_provider = "openrouter"  
  
    [llm.openrouter]  
    type = "openai"  
    model = "deepseek/deepseek-chat-v3-0324:free"  
    api_key = "your-key"  
    base_url = "https://openrouter.ai/api/v1"  
    timeout = 30  
    max_tokens = 8192  
  
    # Load from configuration file  
    forge = AIForgeEngine(config_file="aiforge.toml")  
  
## 🎭 Use Cases  
  
### 💼 Business Intelligence  
- **Market Analysis** - Real-time data mining and trend prediction  
- **Risk Assessment** - Multi-dimensional risk model construction  
- **Decision Support** - Data-driven intelligent decision engines  
  
### 🔬 Research & Development  
- **Data Science** - Automated experiment design and analysis  
- **Model Training** - Intelligent hyperparameter optimization  
- **Research Assistance** - Data visualization and presentation  
  
### 🛠️ Development Acceleration  
- **Prototype Validation** - Rapid MVP construction  
- **API Integration** - Intelligent interface adaptation  
- **DevOps Automation** - System monitoring and maintenance  
  
### 🎨 Creative Implementation  
- **Content Generation** - Multimedia content intelligent creation  
- **Data Art** - Transform data into visual art  
- **Interactive Design** - Smart UI/UX prototype generation  
  
## 🤝 Development & Contributing  
  
    # Developer setup  
    git clone https://github.com/iniwap/AIForge.git  
    cd AIForge  
    pip install -e ".[dev]"  
  
    # Run tests  
    pytest tests/  
  
## 📞 Connect & Support  
  
- 🌐 **Website**: [aiforge.dev](https://iniwap.github.io/AIForge)  
- 💬 **Community**: [Discord](https://discord.gg/Vp35uSBsrw)  
- 📧 **Contact**: iniwaper@gmail.com  
- 🐦 **Updates**: [@AIForge](https://twitter.com/iafun_tipixel)  
- 📦 **PyPI**: [aiforge-engine](https://pypi.org/project/aiforge-engine/)  
  
---  
  
<div align="center">  
  
**🌟 Redefining the Boundaries of Possibility 🌟**  
  
*AIForge - Where Intelligence Meets Execution*  
  
[Get Started](https://pypi.org/project/aiforge-engine/) | [View Documentation](https://iniwap.github.io/AIForge) | [Join Community](https://discord.gg/Vp35uSBsrw)  
  
</div>