Skip to main content

🚀 AIForge - Intelligent Intent Adaptive Execution Engine

Python PyWebView FastAPI SentenceTransformers
PyPI version Downloads AI Powered License Stars
Development Status Development Status

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

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


🎯 What is AIForge?

🚧 Project Status: We are currently in full development, with quite frequent version updates. Please stay tuned!

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 - OpenAI、DeepSeek、OpenRouter、Ollama

LOGO

✨ 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
  • Desktop GUI - Desktop app gui

🤖 LLM Provider Support

  • OpenAI - GPT models integration
  • DeepSeek - Cost-effective AI provider
  • OpenRouter - Multi-model access platform
  • Ollama - Local model execution

🔧 Advanced Execution Management

  • Docker Deployment - Supports both deployment methods
  • 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 & Deployment

  • Product(Package)
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  
pip install "aiforge-engine[deploy]"  # Deploy support    
pip install "aiforge-engine[web,deploy]" # Web + deploy
  • Develop(Source Code)
git clone https://github.com/iniwap/AIForge.git  
cd AIForge

uv venv --python 3.10  
source .venv/bin/activate  # macOS/Linux  
# .venv\Scripts\activate  # Windows

uv sync --all-extras

Basic Usage

  • Product(Package)
# Direct
from aiforge import AIForgeEngine    
print(AIForgeEngine(api_key="your-openrouter-apikey").("Search for the latest global stock market trends and write an investment analysis"))

# CLI 
aiforge "Search for the latest global stock market trends and write an investment analysis" --api-key sk-or-v1-xxx
  
# Web 
aiforge web --api-key sk-or-v1-xxx  # open http://localhost:8000  

# Web Docker
export OPENROUTER_API_KEY="your-key-here"
aiforge-deploy docker start --searxng

# Desktop GUI
aiforge gui --api-key sk-or-v1-xxx
  • Develop(Source Code)
# Direct
from aiforge import AIForgeEngine    
print(AIForgeEngine(api_key="your-openrouter-apikey").("Search for the latest global stock market trends and write an investment analysis"))

# CLI
./aiforge-dev.sh "Search for the latest global stock market trends and write an investment analysis" --api-key sk-or-v1-xxx # win:./aiforge-dev.bat
  
# Web 
./aiforge-dev.sh web --api-key sk-or-v1-xxx  # open http://localhost:8000  

# Web Docker
export OPENROUTER_API_KEY="your-key-here"
./aiforge-dev.sh docker start --searxng --dev

# Desktop GUI
./aiforge-dev.sh gui # --api-key sk-or-v1-xxx --debug

Command List

  • AIForge Command Usage Comparison Table
Feature Development Mode Package Mode Core Parameters
Web Service ./aiforge-dev.sh web aiforge web --host 0.0.0.0 --port 8000 --reload --debug --api-key --provider
GUI Application ./aiforge-dev.sh gui aiforge gui --theme dark --remote-url --width 1200 --height 800 --debug --api-key --provider
GUI Remote ./aiforge-dev.sh gui --remote URL aiforge gui --remote-url URL --remote-url http://server:port
GUI Auto Remote ./aiforge-dev.sh gui --auto-remote - --auto-remote --api-key (Development mode only)
Docker Deployment ./aiforge-dev.sh deploy docker start aiforge-deploy docker start --dev --searxng --mode web --host --port --deep
K8S Deployment ./aiforge-dev.sh deploy k8s deploy aiforge-deploy k8s deploy --namespace aiforge --replicas 1
AWS Cloud Deploy ./aiforge-dev.sh deploy cloud aws deploy aiforge-deploy cloud aws deploy --region us-west-2 --instance-type t3.medium
Azure Cloud Deploy ./aiforge-dev.sh deploy cloud azure deploy aiforge-deploy cloud azure deploy --region eastus --instance-type
GCP Cloud Deploy ./aiforge-dev.sh deploy cloud gcp deploy aiforge-deploy cloud gcp deploy --region us-central1-a --instance-type
Aliyun Cloud Deploy ./aiforge-dev.sh deploy cloud aliyun deploy aiforge-deploy cloud aliyun deploy --region cn-hangzhou --instance-type
Direct Execution python -m aiforge.cli.main "instruction" aiforge "instruction" --provider openrouter --config --api-key
CLI Mode python -m aiforge.cli.main cli "instruction" aiforge cli "instruction" --provider --config --api-key
  • Common Parameters
Parameter Category Parameter Description Default Value
Authentication --api-key LLM provider API key Environment variable
Configuration --provider LLM provider (openrouter/deepseek/ollama) openrouter
Configuration --config Configuration file path -
Debug --debug Enable debug mode false
Debug --verbose, -v Verbose output false
  • Environment Variable Support
Environment Variable Description Example
OPENROUTER_API_KEY OpenRouter API key sk-or-v1-xxx
DEEPSEEK_API_KEY DeepSeek API key sk-xxx
AIFORGE_API_KEY AIForge universal API key -
AIFORGE_LOCALE Interface language zh/en
AIFORGE_DOCKER_MODE Docker mode identifier true

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  
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


🌟 Redefining the Boundaries of Possibility 🌟

AIForge - Where Intelligence Meets Execution

Get Started | View Documentation | Join Community

Metadata

Release files for aiforge-engine 0.0.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiforge-engine 0.0.20
File Size Uploaded Provenance Actions
aiforge_engine-0.0.20.tar.gz 1.1 MB Without provenance Details for aiforge_engine-0.0.20.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aiforge-engine 0.0.20
File Interpreter ABI Platform Actions
aiforge_engine-0.0.20-py3-none-any.whl Python 3 none any Details for aiforge_engine-0.0.20-py3-none-any.whl

Total release size: 2.2 MB

Release files / aiforge_engine-0.0.20.tar.gz

Download URL aiforge_engine-0.0.20.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
92994cfe4c648f477bba6ef0af2813a02db67c8c22595008bf1b62cf33f355f6
BLAKE2b-256 checksum
How to use checksums
94f744cb952fe3fe9e368bfebea0768ec6f9ff26a9d64be64779d26b85281372
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.4

Release files / aiforge_engine-0.0.20-py3-none-any.whl

Download URL aiforge_engine-0.0.20-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
47c924a1d9dcfdd3026ba6d86a1fa5cbe9e82cef6a0cca1be94875af36b0ebe7
BLAKE2b-256 checksum
How to use checksums
de80d4a5f73e6f20309c495aba78d4a55ce8d3cc0b2420609f935e0a89d93c67
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.4

Security for aiforge-engine 0.0.20

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page