aiforge-engine 0.0.9

Intelligent Intent Adaptive Execution Engine - 智能意图自适应执行引擎

🚀 AIForge - Intelligent Intent Adaptive Execution Engine

Transform natural language instructions into executable code with AI-powered automation

🚀 Quick Start • 🧠 Core Features • ⚡ Installation • 🌐 Ecosystem

---

🎯 What is AIForge?

⚠️ Development Status: This project is currently in active development. APIs may change frequently as we iterate and improve.

🚧 Project Status: Actively developed, feedback and contributions welcome!

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

• Template System - Domain-specific execution templates
• Search Integration - Multi-engine search capabilities (Baidu, Bing, 360, Sogou)
• Content Generation - Specialized content creation workflows

🌍 Multi-Language Support

• Global Instruction Processing - Natural language instruction recognition in 12 major languages
• Localized Keywords - Chinese, English, Arabic, German, Spanish, French, Hindi, Japanese, Korean, Portuguese, Russian, Vietnamese
• Smart Language Detection - Automatic language detection with corresponding keyword library matching
• Cross-Language Compatibility - Maintains English keyword universality while providing localized experience

🛡️ Enterprise-Ready Features

• Progress Tracking - Real-time execution status indicators
• Error Handling - Comprehensive exception management and retry logic
• Configuration Management - Flexible TOML-based configuration system

🔐 Enterprise Security Features

AIForge provides multi-layer security for safe AI code execution:

• Sandbox Isolation: Process-level isolation with resource limits
• Network Security: Four-tier policy control with smart domain filtering
• Code Analysis: Dangerous pattern detection and safe module imports
• Unified Middleware: Extensible security validation framework

🚀 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 (OpenRouter default)
forge = AIForgeEngine(api_key="your-openrouter-apikey")  

# Execute natural language instruction  
result = forge("Search for the latest trends in global stock markets, analyze them, and write an investment recommendation")  
print(result)  

Advanced Configuration

# Provider-specific configuration  
forge = AIForgeEngine(  
    api_key="your-deepseek-key",  
    provider="deepseek",  
    locale="en", # ar|de|en|es|fr|hi|ja|ko|pt|ru|vi|zh
    max_rounds=5,
)  

# 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
• 💬 Community: Discord
• 📧 Contact: [e-mail]
• 🐦 Updates: @AIForge
• 📦 PyPI: aiforge-engine

---

🌟 Redefining the Boundaries of Possibility 🌟

AIForge - Where Intelligence Meets Execution

Get Started | View Documentation | Join Community