genxai-framework 0.1.0__tar.gz → 0.1.2__tar.gz

{genxai_framework-0.1.0 → genxai_framework-0.1.2}/ARCHITECTURE.md

@@ -1,8 +1,8 @@
 # GenXAI Framework - Architecture Documentation
 
 **Version:** 1.0.0  
-**Last Updated:** January 28, 2026  
-**Status:** Design Phase
+**Last Updated:** February 3, 2026  
+**Status:** Active Development
 
 ---
 

{genxai_framework-0.1.0 → genxai_framework-0.1.2}/CONTRIBUTING.md

@@ -40,8 +40,8 @@ Thank you for your interest in contributing to GenXAI! This document provides gu
 
 ```bash
 # Clone the repository
-git clone https://github.com/genxai/genxai.git
-cd genxai
+git clone https://github.com/irsal2012/GenXAI.git
+cd GenXAI
 
 # Create virtual environment
 python3 -m venv venv

{genxai_framework-0.1.0 → genxai_framework-0.1.2}/GETTING_STARTED.md

@@ -8,8 +8,8 @@ Welcome to GenXAI - an advanced agentic AI framework with graph-based orchestrat
 
 ```bash
 # Clone the repository
-git clone https://github.com/genxai/genxai.git
-cd genxai
+git clone https://github.com/irsal2012/GenXAI.git
+cd GenXAI
 
 # Install dependencies
 pip install -e ".[dev,llm]"

{genxai_framework-0.1.0 → genxai_framework-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: genxai-framework
-Version: 0.1.0
+Version: 0.1.2
 Summary: Advanced Agentic AI Framework with Graph-Based Orchestration
 Author-email: GenXAI Team <team@genxai.dev>
 License: MIT
@@ -81,9 +81,9 @@ Dynamic: license-file
 
 # GenXAI - Advanced Agentic AI Framework
 
-**Version:** 1.0.0 (Design Phase)  
-**Status:** Planning & Architecture  
-**License:** MIT (Planned)
+**Version:** 1.0.0  
+**Status:** Active Development  
+**License:** MIT
 
 ---
 
@@ -155,7 +155,7 @@ Comprehensive documentation is available in the following files:
 
 - **[ARCHITECTURE.md](./ARCHITECTURE.md)** - Complete system architecture and design principles
 - **[REQUIREMENTS.md](./REQUIREMENTS.md)** - Detailed functional and non-functional requirements
-- **[IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md)** - 20-week development roadmap
+- **[IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md)** - Development roadmap
 - **[TOOLS_DESIGN.md](./TOOLS_DESIGN.md)** - Tool system architecture and 50+ built-in tools
 - **[MEMORY_DESIGN.md](./MEMORY_DESIGN.md)** - Multi-layered memory system design
 
@@ -229,7 +229,7 @@ See [ARCHITECTURE.md](./ARCHITECTURE.md) for complete details.
 - Beta testing
 - Official launch 🚀
 
-See [IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md) for detailed timeline.
+See [IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md) for the timeline.
 
 ---
 
@@ -286,6 +286,48 @@ graph.add_edge(Edge(source="support", target="end"))
 result = await graph.run(input_data="My app crashed")
 ```
 
+### Flow Orchestrator Examples
+
+GenXAI also ships with lightweight flow orchestrators for common patterns:
+
+```python
+from genxai import AgentFactory, RoundRobinFlow, SelectorFlow, P2PFlow
+
+agents = [
+    AgentFactory.create_agent(id="analyst", role="Analyst", goal="Analyze"),
+    AgentFactory.create_agent(id="writer", role="Writer", goal="Write"),
+]
+
+# Round-robin flow
+round_robin = RoundRobinFlow(agents)
+
+# Selector flow
+def choose_next(state, agent_ids):
+    return agent_ids[state.get("selector_hop", 0) % len(agent_ids)]
+
+selector = SelectorFlow(agents, selector=choose_next, max_hops=3)
+
+# P2P flow
+p2p = P2PFlow(agents, max_rounds=4, consensus_threshold=0.7)
+```
+
+See runnable examples in:
+- `examples/code/flow_round_robin_example.py`
+- `examples/code/flow_selector_example.py`
+- `examples/code/flow_p2p_example.py`
+- `examples/code/flow_parallel_example.py`
+- `examples/code/flow_conditional_example.py`
+- `examples/code/flow_loop_example.py`
+- `examples/code/flow_router_example.py`
+- `examples/code/flow_ensemble_voting_example.py`
+- `examples/code/flow_critic_review_example.py`
+- `examples/code/flow_coordinator_worker_example.py`
+- `examples/code/flow_map_reduce_example.py`
+- `examples/code/flow_subworkflow_example.py`
+- `examples/code/flow_auction_example.py`
+
+Full flow documentation: [docs/FLOWS.md](./docs/FLOWS.md)
+
 ### Trigger SDK Quick Start
 
 ```python
@@ -350,6 +392,16 @@ workflow:
         condition: "category == 'technical'"
 ```
 
+Shared memory template:
+
+```bash
+genxai workflow run examples/nocode/shared_memory_workflow.yaml \
+  --input '{"task": "Draft a short response"}'
+```
+
+See no-code templates (including a shared memory example) in:
+- `examples/nocode/README.md`
+
 ---
 
 ## 🛠️ Technology Stack
@@ -443,10 +495,9 @@ workflow:
 
 ## 🤝 Contributing
 
-We welcome contributions! This project is currently in the design phase. Once implementation begins, we'll provide:
+We welcome contributions! This project is in active development. We provide:
 
 - Contributing guidelines
-- Code of conduct
 - Development setup instructions
 - Issue templates
 - Pull request templates
@@ -455,7 +506,7 @@ We welcome contributions! This project is currently in the design phase. Once im
 
 ## 📜 License
 
-MIT License (Planned)
+MIT License
 
 ---
 
@@ -486,9 +537,9 @@ Inspired by:
 
 ## 📈 Project Status
 
-**Current Phase**: Design & Planning  
-**Next Milestone**: Begin Phase 1 implementation  
-**Expected Launch**: Week 20 (approximately 5 months from start)
+**Current Phase**: Active Development  
+**Next Milestone**: Complete visual editor + studio polish  
+**Expected Launch**: TBD
 
 ---
 

{genxai_framework-0.1.0 → genxai_framework-0.1.2}/README.md

@@ -1,8 +1,8 @@
 # GenXAI - Advanced Agentic AI Framework
 
-**Version:** 1.0.0 (Design Phase)  
-**Status:** Planning & Architecture  
-**License:** MIT (Planned)
+**Version:** 1.0.0  
+**Status:** Active Development  
+**License:** MIT
 
 ---
 
@@ -74,7 +74,7 @@ Comprehensive documentation is available in the following files:
 
 - **[ARCHITECTURE.md](./ARCHITECTURE.md)** - Complete system architecture and design principles
 - **[REQUIREMENTS.md](./REQUIREMENTS.md)** - Detailed functional and non-functional requirements
-- **[IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md)** - 20-week development roadmap
+- **[IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md)** - Development roadmap
 - **[TOOLS_DESIGN.md](./TOOLS_DESIGN.md)** - Tool system architecture and 50+ built-in tools
 - **[MEMORY_DESIGN.md](./MEMORY_DESIGN.md)** - Multi-layered memory system design
 
@@ -148,7 +148,7 @@ See [ARCHITECTURE.md](./ARCHITECTURE.md) for complete details.
 - Beta testing
 - Official launch 🚀
 
-See [IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md) for detailed timeline.
+See [IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md) for the timeline.
 
 ---
 
@@ -205,6 +205,48 @@ graph.add_edge(Edge(source="support", target="end"))
 result = await graph.run(input_data="My app crashed")
 ```
 
+### Flow Orchestrator Examples
+
+GenXAI also ships with lightweight flow orchestrators for common patterns:
+
+```python
+from genxai import AgentFactory, RoundRobinFlow, SelectorFlow, P2PFlow
+
+agents = [
+    AgentFactory.create_agent(id="analyst", role="Analyst", goal="Analyze"),
+    AgentFactory.create_agent(id="writer", role="Writer", goal="Write"),
+]
+
+# Round-robin flow
+round_robin = RoundRobinFlow(agents)
+
+# Selector flow
+def choose_next(state, agent_ids):
+    return agent_ids[state.get("selector_hop", 0) % len(agent_ids)]
+
+selector = SelectorFlow(agents, selector=choose_next, max_hops=3)
+
+# P2P flow
+p2p = P2PFlow(agents, max_rounds=4, consensus_threshold=0.7)
+```
+
+See runnable examples in:
+- `examples/code/flow_round_robin_example.py`
+- `examples/code/flow_selector_example.py`
+- `examples/code/flow_p2p_example.py`
+- `examples/code/flow_parallel_example.py`
+- `examples/code/flow_conditional_example.py`
+- `examples/code/flow_loop_example.py`
+- `examples/code/flow_router_example.py`
+- `examples/code/flow_ensemble_voting_example.py`
+- `examples/code/flow_critic_review_example.py`
+- `examples/code/flow_coordinator_worker_example.py`
+- `examples/code/flow_map_reduce_example.py`
+- `examples/code/flow_subworkflow_example.py`
+- `examples/code/flow_auction_example.py`
+
+Full flow documentation: [docs/FLOWS.md](./docs/FLOWS.md)
+
 ### Trigger SDK Quick Start
 
 ```python
@@ -269,6 +311,16 @@ workflow:
         condition: "category == 'technical'"
 ```
 
+Shared memory template:
+
+```bash
+genxai workflow run examples/nocode/shared_memory_workflow.yaml \
+  --input '{"task": "Draft a short response"}'
+```
+
+See no-code templates (including a shared memory example) in:
+- `examples/nocode/README.md`
+
 ---
 
 ## 🛠️ Technology Stack
@@ -362,10 +414,9 @@ workflow:
 
 ## 🤝 Contributing
 
-We welcome contributions! This project is currently in the design phase. Once implementation begins, we'll provide:
+We welcome contributions! This project is in active development. We provide:
 
 - Contributing guidelines
-- Code of conduct
 - Development setup instructions
 - Issue templates
 - Pull request templates
@@ -374,7 +425,7 @@ We welcome contributions! This project is currently in the design phase. Once im
 
 ## 📜 License
 
-MIT License (Planned)
+MIT License
 
 ---
 
@@ -405,9 +456,9 @@ Inspired by:
 
 ## 📈 Project Status
 
-**Current Phase**: Design & Planning  
-**Next Milestone**: Begin Phase 1 implementation  
-**Expected Launch**: Week 20 (approximately 5 months from start)
+**Current Phase**: Active Development  
+**Next Milestone**: Complete visual editor + studio polish  
+**Expected Launch**: TBD
 
 ---
 

genxai_framework-0.1.2/cli/commands/__init__.py

@@ -0,0 +1,8 @@
+"""CLI commands for GenXAI."""
+
+from cli.commands.tool import tool
+from cli.commands.metrics import metrics
+from cli.commands.connector import connector
+from cli.commands.workflow import workflow
+
+__all__ = ["tool", "metrics", "connector", "workflow"]

genxai_framework-0.1.2/cli/commands/connector.py

@@ -0,0 +1,309 @@
+"""Connector management CLI commands."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+from typing import Any, Dict, Optional
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+from genxai.connectors import (
+    Connector,
+    KafkaConnector,
+    SQSConnector,
+    PostgresCDCConnector,
+    WebhookConnector,
+    SlackConnector,
+    GitHubConnector,
+    NotionConnector,
+    JiraConnector,
+    GoogleWorkspaceConnector,
+)
+from genxai.connectors.config_store import ConnectorConfigEntry, ConnectorConfigStore
+
+console = Console()
+
+
+CONNECTOR_CATALOG: Dict[str, Dict[str, Any]] = {
+    "kafka": {
+        "class": KafkaConnector,
+        "required": ["topic", "bootstrap_servers"],
+        "description": "Kafka consumer connector",
+    },
+    "sqs": {
+        "class": SQSConnector,
+        "required": ["queue_url"],
+        "description": "AWS SQS connector",
+    },
+    "postgres_cdc": {
+        "class": PostgresCDCConnector,
+        "required": ["dsn"],
+        "description": "Postgres CDC connector",
+    },
+    "webhook": {
+        "class": WebhookConnector,
+        "required": [],
+        "description": "Inbound webhook connector",
+    },
+    "slack": {
+        "class": SlackConnector,
+        "required": ["bot_token"],
+        "description": "Slack Web API connector",
+    },
+    "github": {
+        "class": GitHubConnector,
+        "required": ["token"],
+        "description": "GitHub REST API connector",
+    },
+    "notion": {
+        "class": NotionConnector,
+        "required": ["token"],
+        "description": "Notion API connector",
+    },
+    "jira": {
+        "class": JiraConnector,
+        "required": ["email", "api_token", "base_url"],
+        "description": "Jira Cloud REST API connector",
+    },
+    "google_workspace": {
+        "class": GoogleWorkspaceConnector,
+        "required": ["access_token"],
+        "description": "Google Workspace APIs connector",
+    },
+}
+
+
+@click.group()
+def connector() -> None:
+    """Manage GenXAI connectors."""
+    pass
+
+
+@connector.command("list")
+@click.option("--format", "output_format", type=click.Choice(["table", "json"]), default="table")
+def list_connectors(output_format: str) -> None:
+    """List available connector types."""
+    if output_format == "json":
+        payload = {
+            name: {
+                "required": meta["required"],
+                "description": meta["description"],
+            }
+            for name, meta in CONNECTOR_CATALOG.items()
+        }
+        click.echo(json.dumps(payload, indent=2))
+        return
+
+    table = Table(title="GenXAI Connectors")
+    table.add_column("Type", style="cyan")
+    table.add_column("Required Fields", style="green")
+    table.add_column("Description", style="white")
+    for name, meta in CONNECTOR_CATALOG.items():
+        table.add_row(name, ", ".join(meta["required"]) or "(none)", meta["description"])
+    console.print(table)
+
+
+@connector.command("validate")
+@click.option("--type", "connector_type", required=True, help="Connector type")
+@click.option("--connector-id", default="connector", show_default=True)
+@click.option("--config", help="JSON config payload for the connector")
+@click.option("--config-name", help="Use a saved connector config")
+def validate(
+    connector_type: str,
+    connector_id: str,
+    config: Optional[str],
+    config_name: Optional[str],
+) -> None:
+    """Validate connector configuration without starting it."""
+    connector_meta = CONNECTOR_CATALOG.get(connector_type)
+    if not connector_meta:
+        raise click.ClickException(
+            f"Unknown connector type '{connector_type}'. Use 'genxai connector list' to see options."
+        )
+
+    config_data = _load_config(config, config_name)
+    missing = [field for field in connector_meta["required"] if field not in config_data]
+    if missing:
+        raise click.ClickException(f"Missing required fields: {', '.join(missing)}")
+
+    connector_instance = _build_connector(connector_id, connector_meta["class"], config_data)
+    try:
+        asyncio.run(connector_instance.validate_config())
+        console.print("[green]✓ Connector configuration valid[/green]")
+    except Exception as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
+@connector.command("start")
+@click.option("--type", "connector_type", required=True, help="Connector type")
+@click.option("--connector-id", default="connector", show_default=True)
+@click.option("--config", help="JSON config payload for the connector")
+@click.option("--config-name", help="Use a saved connector config")
+def start(connector_type: str, connector_id: str, config: Optional[str], config_name: Optional[str]) -> None:
+    """Start a connector instance for quick validation."""
+    connector_instance = _build_from_cli(connector_type, connector_id, config, config_name)
+    try:
+        asyncio.run(connector_instance.start())
+        console.print("[green]✓ Connector started[/green]")
+    except Exception as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
+@connector.command("stop")
+@click.option("--type", "connector_type", required=True, help="Connector type")
+@click.option("--connector-id", default="connector", show_default=True)
+@click.option("--config", help="JSON config payload for the connector")
+@click.option("--config-name", help="Use a saved connector config")
+def stop(connector_type: str, connector_id: str, config: Optional[str], config_name: Optional[str]) -> None:
+    """Stop a connector instance for quick validation."""
+    connector_instance = _build_from_cli(connector_type, connector_id, config, config_name)
+    try:
+        asyncio.run(connector_instance.stop())
+        console.print("[green]✓ Connector stopped[/green]")
+    except Exception as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
+@connector.command("health")
+@click.option("--type", "connector_type", required=True, help="Connector type")
+@click.option("--connector-id", default="connector", show_default=True)
+@click.option("--config", help="JSON config payload for the connector")
+@click.option("--format", "output_format", type=click.Choice(["json", "table"]), default="json")
+@click.option("--config-name", help="Use a saved connector config")
+def health(
+    connector_type: str,
+    connector_id: str,
+    config: Optional[str],
+    output_format: str,
+    config_name: Optional[str],
+) -> None:
+    """Run a connector health check without starting it."""
+    connector_instance = _build_from_cli(connector_type, connector_id, config, config_name)
+    try:
+        payload = asyncio.run(connector_instance.health_check())
+    except Exception as exc:
+        raise click.ClickException(str(exc)) from exc
+
+    if output_format == "json":
+        click.echo(json.dumps(payload, indent=2))
+        return
+
+    table = Table(title="Connector Health")
+    table.add_column("Field", style="cyan")
+    table.add_column("Value", style="white")
+    for key, value in payload.items():
+        table.add_row(str(key), str(value))
+    console.print(table)
+
+
+@connector.command("save")
+@click.option("--name", "config_name", required=True, help="Name for the saved config")
+@click.option("--type", "connector_type", required=True, help="Connector type")
+@click.option("--config", required=True, help="JSON config payload")
+def save(config_name: str, connector_type: str, config: str) -> None:
+    """Save a connector config for reuse."""
+    connector_meta = CONNECTOR_CATALOG.get(connector_type)
+    if not connector_meta:
+        raise click.ClickException(
+            f"Unknown connector type '{connector_type}'. Use 'genxai connector list' to see options."
+        )
+    config_data = _load_config(config, None)
+    missing = [field for field in connector_meta["required"] if field not in config_data]
+    if missing:
+        raise click.ClickException(f"Missing required fields: {', '.join(missing)}")
+
+    store = ConnectorConfigStore()
+    store.save(
+        ConnectorConfigEntry(
+            name=config_name,
+            connector_type=connector_type,
+            config=config_data,
+        )
+    )
+    console.print(f"[green]✓ Saved connector config '{config_name}'[/green]")
+
+
+@connector.command("saved")
+@click.option("--format", "output_format", type=click.Choice(["table", "json"]), default="table")
+def list_saved(output_format: str) -> None:
+    """List saved connector configs."""
+    store = ConnectorConfigStore()
+    entries = store.list()
+    if output_format == "json":
+        payload = {
+            name: {"connector_type": entry.connector_type, "config": entry.config}
+            for name, entry in entries.items()
+        }
+        click.echo(json.dumps(payload, indent=2))
+        return
+
+    table = Table(title="Saved Connector Configs")
+    table.add_column("Name", style="cyan")
+    table.add_column("Type", style="green")
+    table.add_column("Config", style="white")
+    for name, entry in entries.items():
+        table.add_row(name, entry.connector_type, json.dumps(entry.config))
+    console.print(table)
+
+
+@connector.command("remove")
+@click.option("--name", "config_name", required=True, help="Saved config name")
+def remove(config_name: str) -> None:
+    """Remove a saved connector config."""
+    store = ConnectorConfigStore()
+    if not store.delete(config_name):
+        raise click.ClickException(f"Config '{config_name}' not found")
+    console.print(f"[green]✓ Removed connector config '{config_name}'[/green]")
+
+
+@connector.command("keygen")
+def keygen() -> None:
+    """Generate a Fernet key for encrypted connector configs."""
+    try:
+        from cryptography.fernet import Fernet
+    except ImportError as exc:
+        raise click.ClickException(
+            "cryptography is required for key generation. Install with: pip install cryptography"
+        ) from exc
+    key = Fernet.generate_key().decode()
+    click.echo(key)
+
+
+def _build_connector(connector_id: str, connector_class: type[Connector], config: Dict[str, Any]) -> Connector:
+    params = {"connector_id": connector_id, **config}
+    return connector_class(**params)
+
+
+def _build_from_cli(
+    connector_type: str,
+    connector_id: str,
+    config: Optional[str],
+    config_name: Optional[str],
+) -> Connector:
+    connector_meta = CONNECTOR_CATALOG.get(connector_type)
+    if not connector_meta:
+        raise click.ClickException(
+            f"Unknown connector type '{connector_type}'. Use 'genxai connector list' to see options."
+        )
+    config_data = _load_config(config, config_name)
+    missing = [field for field in connector_meta["required"] if field not in config_data]
+    if missing:
+        raise click.ClickException(f"Missing required fields: {', '.join(missing)}")
+    return _build_connector(connector_id, connector_meta["class"], config_data)
+
+
+def _load_config(config: Optional[str], config_name: Optional[str]) -> Dict[str, Any]:
+    if config_name:
+        store = ConnectorConfigStore()
+        entry = store.get(config_name)
+        if not entry:
+            raise click.ClickException(f"Config '{config_name}' not found")
+        return entry.config
+    return json.loads(config) if config else {}
+
+
+if __name__ == "__main__":
+    connector()