praisonai Rust SDK implementation v0.1.0

Author: MervinPraison

.gitignore

@@ -85,4 +85,10 @@ issue_details.json
 
 *.log
 .internal
-.praisonai
+.praisonai
+
+# Rust / Cargo
+target/
+Cargo.lock
+**/*.rs.bk
+*.pdb

src/praisonai-rust/Cargo.toml

@@ -0,0 +1,74 @@
+[workspace]
+resolver = "2"
+members = [
+    "praisonai",
+    "praisonai-derive",
+    "praisonai-cli",
+]
+
+[workspace.package]
+version = "0.1.0"
+edition = "2021"
+license = "MIT"
+authors = ["MervinPraison"]
+repository = "https://github.com/MervinPraison/PraisonAI"
+homepage = "https://docs.praison.ai"
+description = "High-performance, agentic AI framework for Rust"
+keywords = ["ai", "agents", "llm", "openai", "anthropic"]
+categories = ["api-bindings", "asynchronous"]
+
+[workspace.dependencies]
+# Core async runtime
+tokio = { version = "1", features = ["full"] }
+async-trait = "0.1"
+futures = "0.3"
+
+# Serialization
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+serde_yaml = "0.9"
+
+# Error handling
+thiserror = "2"
+anyhow = "1"
+
+# CLI
+clap = { version = "4", features = ["derive"] }
+
+# LLM providers (via rig-core for multi-provider support)
+rig-core = "0.9"
+
+# HTTP client
+reqwest = { version = "0.12", features = ["json", "stream"] }
+
+# Logging
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+# UUID for session/agent IDs
+uuid = { version = "1", features = ["v4"] }
+
+# Optional: TUI
+ratatui = "0.29"
+crossterm = "0.28"
+
+# Optional: MCP support
+# rmcp = { version = "0.12", optional = true }
+
+# Testing
+tokio-test = "0.4"
+
+# Proc macro dependencies
+syn = { version = "2", features = ["full", "parsing", "extra-traits"] }
+quote = "1"
+proc-macro2 = "1"
+
+[profile.release]
+lto = true
+codegen-units = 1
+strip = true
+panic = "abort"
+
+[profile.dev]
+opt-level = 0
+debug = true

src/praisonai-rust/FEATURE_PARITY_TRACKER.json

@@ -1,13 +1,40 @@
 {
-  "version": "1.5.5",
+  "version": "0.1.0",
   "lastUpdated": "2026-02-04",
-  "generatedBy": "praisonai._dev.parity.generator",
+  "generatedBy": "manual",
   "sourceOfTruth": "Python SDK (praisonaiagents)",
-  "status": "NOT_STARTED",
+  "status": "IN_PROGRESS",
   "summary": {
     "pythonCoreFeatures": 282,
-    "rustFeatures": 0,
-    "gapCount": 282
+    "rustFeatures": 25,
+    "gapCount": 257,
+    "implementedFeatures": [
+      "Agent",
+      "AgentBuilder",
+      "AgentConfig",
+      "AgentTeam",
+      "AgentFlow",
+      "Tool",
+      "ToolResult",
+      "ToolRegistry",
+      "#[tool] macro",
+      "LlmProvider",
+      "LlmConfig",
+      "Message",
+      "Role",
+      "Memory",
+      "MemoryAdapter",
+      "ConversationHistory",
+      "MemoryConfig",
+      "HooksConfig",
+      "OutputConfig",
+      "ExecutionConfig",
+      "Process (Sequential/Parallel/Hierarchical)",
+      "Route",
+      "Parallel",
+      "Loop",
+      "Repeat"
+    ]
   },
   "pythonCoreSDK": {
     "exports": [
@@ -296,8 +323,39 @@
     ]
   },
   "rustSDK": {
-    "path": "/home/runner/work/PraisonAI/PraisonAI/src/praisonai-rust",
-    "exports": [],
-    "modules": {}
+    "path": "/Users/praison/praisonai-package/src/praisonai-rust",
+    "crates": {
+      "praisonai": {
+        "modules": ["agent", "tools", "llm", "memory", "workflows", "config", "error"],
+        "exports": [
+          "Agent", "AgentBuilder", "AgentConfig",
+          "Tool", "ToolResult", "ToolRegistry", "ToolDefinition",
+          "LlmProvider", "LlmConfig", "Message", "Role", "ToolCall", "LlmResponse", "Usage", "OpenAiProvider",
+          "Memory", "MemoryAdapter", "ConversationHistory", "InMemoryAdapter",
+          "AgentTeam", "AgentFlow", "Process", "StepResult", "WorkflowContext", "Route", "Parallel", "Loop", "Repeat",
+          "MemoryConfig", "HooksConfig", "OutputConfig", "ExecutionConfig",
+          "Error", "Result"
+        ]
+      },
+      "praisonai-derive": {
+        "exports": ["tool"]
+      },
+      "praisonai-cli": {
+        "binary": "praisonai-rust",
+        "commands": ["chat", "run", "prompt"]
+      }
+    },
+    "examples": [
+      "basic_agent",
+      "with_tools", 
+      "multi_agent",
+      "memory_example",
+      "config_example",
+      "workflow_patterns"
+    ],
+    "tests": {
+      "unit_tests": 20,
+      "status": "all_passing"
+    }
   }
 }

src/praisonai-rust/README.md

@@ -0,0 +1,104 @@
+# PraisonAI Rust SDK
+
+High-performance, agentic AI framework for Rust.
+
+## Quick Start
+
+```rust
+use praisonai::{Agent, tool, Tool};
+
+#[tool(description = "Search the web")]
+async fn search(query: String) -> String {
+    format!("Results for: {}", query)
+}
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    let agent = Agent::new()
+        .instructions("You are a helpful assistant")
+        .tool(SearchTool::new())
+        .build()?;
+    
+    let response = agent.chat("Hello!").await?;
+    println!("{}", response);
+    Ok(())
+}
+```
+
+## Installation
+
+Add to your `Cargo.toml`:
+
+```toml
+[dependencies]
+praisonai = "0.1"
+tokio = { version = "1", features = ["full"] }
+```
+
+## CLI Usage
+
+```bash
+# Install CLI
+cargo install praisonai-cli
+
+# Interactive chat
+praisonai-rust chat
+
+# Single-shot prompt
+praisonai-rust "What is 2+2?"
+
+# Run workflow from YAML
+praisonai-rust run agents.yaml
+```
+
+## Features
+
+- **Agent-Centric**: Every design decision centers on Agents
+- **Multi-Provider LLM**: OpenAI, Anthropic, Ollama support via rig-core
+- **Tool System**: `#[tool]` macro for easy tool creation
+- **Multi-Agent Workflows**: AgentTeam, AgentFlow patterns
+- **Memory**: Conversation history and long-term storage
+- **Async-First**: Built on Tokio for high performance
+
+## Crates
+
+| Crate | Description |
+|-------|-------------|
+| `praisonai` | Core library (Agent, Tools, Workflows) |
+| `praisonai-derive` | Proc macros (`#[tool]`) |
+| `praisonai-cli` | CLI binary |
+
+## API Parity with Python
+
+```python
+# Python
+from praisonaiagents import Agent, tool
+
+@tool
+def search(query: str) -> str:
+    """Search the web."""
+    return f"Results for: {query}"
+
+agent = Agent(instructions="Be helpful", tools=[search])
+response = agent.start("Hello!")
+```
+
+```rust
+// Rust
+use praisonai::{Agent, tool, Tool};
+
+#[tool(description = "Search the web")]
+async fn search(query: String) -> String {
+    format!("Results for: {}", query)
+}
+
+let agent = Agent::new()
+    .instructions("Be helpful")
+    .tool(SearchTool::new())
+    .build()?;
+let response = agent.chat("Hello!").await?;
+```
+
+## License
+
+MIT

src/praisonai-rust/examples/basic_agent.rs

@@ -0,0 +1,23 @@
+//! Basic agent example
+//!
+//! Run with: cargo run --example basic_agent
+
+use praisonai::Agent;
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    // Create a simple agent
+    let agent = Agent::new()
+        .name("assistant")
+        .instructions("You are a helpful AI assistant. Be concise and friendly.")
+        .model("gpt-4o-mini")
+        .build()?;
+    
+    println!("Agent created: {}", agent.name());
+    println!("Model: {}", agent.model());
+    
+    let response = agent.chat("What is 2 + 2?").await?;
+    println!("Response: {}", response);
+    
+    Ok(())
+}

src/praisonai-rust/examples/config_example.rs

@@ -0,0 +1,65 @@
+//! Configuration options example
+//!
+//! Run with: cargo run -p praisonai --example config_example
+
+use praisonai::{Agent, OutputConfig, ExecutionConfig, MemoryConfig};
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    println!("=== PraisonAI Configuration Examples ===\n");
+    
+    // 1. Output Configuration
+    println!("1. Output Configuration:");
+    let output_silent = OutputConfig::new().silent();
+    let output_verbose = OutputConfig::new().verbose();
+    let output_json = OutputConfig::new().json().file("output.json");
+    
+    println!("   - Silent mode: {}", output_silent.mode);
+    println!("   - Verbose mode: {}", output_verbose.mode);
+    println!("   - JSON mode: {}, file: {:?}", output_json.mode, output_json.file);
+    
+    // 2. Execution Configuration
+    println!("\n2. Execution Configuration:");
+    let exec_config = ExecutionConfig::new()
+        .max_iterations(5)
+        .timeout(60)
+        .no_stream();
+    
+    println!("   - Max iterations: {}", exec_config.max_iterations);
+    println!("   - Timeout: {} seconds", exec_config.timeout_secs);
+    println!("   - Streaming: {}", exec_config.stream);
+    
+    // 3. Memory Configuration
+    println!("\n3. Memory Configuration:");
+    let mem_config = MemoryConfig::new()
+        .with_long_term()
+        .provider("sqlite")
+        .max_messages(100);
+    
+    println!("   - Short-term: {}", mem_config.use_short_term);
+    println!("   - Long-term: {}", mem_config.use_long_term);
+    println!("   - Provider: {}", mem_config.provider);
+    println!("   - Max messages: {}", mem_config.max_messages);
+    
+    // 4. Agent with all configurations
+    println!("\n4. Creating Agent with Custom Config:");
+    let agent = Agent::new()
+        .name("configured-agent")
+        .instructions("You are a configured assistant.")
+        .model("gpt-4o-mini")
+        .temperature(0.5)
+        .max_tokens(1000)
+        .max_iterations(3)
+        .verbose(true)
+        .stream(false)
+        .memory_config(MemoryConfig::new().max_messages(20))
+        .build()?;
+    
+    println!("   - Name: {}", agent.name());
+    println!("   - Model: {}", agent.model());
+    println!("   - Agent ID: {}", agent.id());
+    
+    println!("\n=== All configurations demonstrated successfully! ===");
+    
+    Ok(())
+}