Metadata-Version: 2.4
Name: jaygoga-orchestra
Version: 1.0.2
Summary: JayGoga-Orchestra - Advanced AI Agent Orchestration Framework
Home-page: https://github.com/AIMLDev726/jaygoga_orchestra
Author: AIMLDev726
Author-email: AIMLDev726 <aistudentlearn4@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/AIMLDev726/jaygoga_orchestra
Project-URL: Documentation, https://docs.jaygoga.ai
Project-URL: Repository, https://github.com/AIMLDev726/jaygoga_orchestra
Project-URL: Issues, https://github.com/AIMLDev726/jaygoga_orchestra/issues
Keywords: ai,agents,workflow,automation,llm,orchestration,jaygoga
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.4.2
Requires-Dist: openai>=1.13.3
Requires-Dist: litellm>=1.74.9
Requires-Dist: instructor>=1.3.3
Requires-Dist: pdfplumber>=0.11.4
Requires-Dist: regex>=2024.9.11
Requires-Dist: opentelemetry-api>=1.30.0
Requires-Dist: opentelemetry-sdk>=1.30.0
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.30.0
Requires-Dist: chromadb>=0.5.23
Requires-Dist: tokenizers>=0.20.3
Requires-Dist: onnxruntime>=1.22.0
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: pyvis>=0.3.2
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyjwt>=2.9.0
Requires-Dist: click>=8.1.7
Requires-Dist: appdirs>=1.4.4
Requires-Dist: jsonref>=1.1.0
Requires-Dist: json-repair>=0.25.2
Requires-Dist: tomli-w>=1.1.0
Requires-Dist: tomli>=2.0.2
Requires-Dist: blinker>=1.9.0
Requires-Dist: json5>=0.10.0
Requires-Dist: portalocker>=2.7.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typing-extensions>=4.0.0
Requires-Dist: requests>=2.25.0
Requires-Dist: anthropic>=0.3.0
Requires-Dist: langchain>=0.1.0
Requires-Dist: langchain-community>=0.0.1
Requires-Dist: langchain-openai>=0.0.1
Requires-Dist: tiktoken>=0.5.0
Requires-Dist: tenacity>=8.0.0
Requires-Dist: PyYAML>=6.0.0
Requires-Dist: jsonschema>=4.0.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: pandas>=2.2.3
Requires-Dist: numpy>=1.24.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Provides-Extra: vectordbs
Requires-Dist: faiss-cpu>=1.7.0; extra == "vectordbs"
Requires-Dist: pinecone-client>=2.2.0; extra == "vectordbs"
Requires-Dist: weaviate-client>=3.15.0; extra == "vectordbs"
Requires-Dist: qdrant-client>=1.6.0; extra == "vectordbs"
Requires-Dist: pgvector>=0.2.0; extra == "vectordbs"
Requires-Dist: lancedb>=0.20.0; extra == "vectordbs"
Requires-Dist: milvus>=2.5.10; extra == "vectordbs"
Provides-Extra: tools
Requires-Dist: arxiv>=1.4.0; extra == "tools"
Requires-Dist: newspaper4k>=0.9.0; extra == "tools"
Requires-Dist: youtube-transcript-api>=0.6.0; extra == "tools"
Requires-Dist: googlemaps>=4.10.0; extra == "tools"
Requires-Dist: matplotlib>=3.7.0; extra == "tools"
Requires-Dist: opencv-python>=4.8.0; extra == "tools"
Requires-Dist: selenium>=4.15.0; extra == "tools"
Requires-Dist: beautifulsoup4>=4.12.0; extra == "tools"
Provides-Extra: files
Requires-Dist: pypdf>=3.0.0; extra == "files"
Requires-Dist: python-docx>=0.8.11; extra == "files"
Requires-Dist: markdown>=3.4.0; extra == "files"
Requires-Dist: unstructured>=0.10.0; extra == "files"
Requires-Dist: docling>=2.12.0; extra == "files"
Provides-Extra: memory
Requires-Dist: mem0ai>=0.1.94; extra == "memory"
Requires-Dist: redis>=4.5.0; extra == "memory"
Requires-Dist: postgresql>=0.8.0; extra == "memory"
Requires-Dist: sqlite3>=3.40.0; extra == "memory"
Provides-Extra: all
Requires-Dist: jaygoga-orchestra[vectordbs]; extra == "all"
Requires-Dist: jaygoga-orchestra[tools]; extra == "all"
Requires-Dist: jaygoga-orchestra[files]; extra == "all"
Requires-Dist: jaygoga-orchestra[memory]; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# JayGoga-Orchestra 🎼 - Advanced AI Agent Orchestration Framework

**JayGoga-Orchestra** is a powerful AI agent orchestration framework for intelligent automation. It provides seamless coordination of AI agents for complex workflows and enterprise-grade automation solutions.

## 🌟 Features

- **🎭 Dual Architecture**: Choose between Classical (v1) and Modern (v2) orchestration patterns
- **🔮 Intelligent Orchestration**: Advanced agent coordination and workflow management
- **⚡ High Performance**: Optimized for speed and scalability
- **🛡️ Enterprise Ready**: Built for production environments
- **🎨 Flexible Design**: Adapt to any AI workflow requirement
- **📚 Rich Documentation**: Comprehensive guides and examples
- **🔄 Seamless Integration**: Easy integration with existing systems

## 🚀 Installation

```bash
pip install jaygoga-orchestra
```

## 🎯 Quick Start

### 🏛️ Classical Orchestration (v1) - Structured & Reliable

Perfect for **structured workflows**, **enterprise environments**, and **predictable processes**.

```python
from jaygoga_orchestra.v1 import Agent, Task, Squad, Process

# Create specialized agents
analyst = Agent(
    role="Senior Data Analyst",
    goal="Extract meaningful insights from complex datasets",
    backstory="You are a seasoned analyst with 10+ years of experience in data science and business intelligence."
)

researcher = Agent(
    role="Market Researcher",
    goal="Gather comprehensive market intelligence",
    backstory="You specialize in market analysis and competitive intelligence gathering."
)

# Define specific tasks
analysis_task = Task(
    description="Analyze Q4 sales data and identify key trends, patterns, and anomalies",
    agent=analyst,
    expected_output="Detailed analysis report with visualizations and recommendations"
)

research_task = Task(
    description="Research market conditions and competitor performance in Q4",
    agent=researcher,
    expected_output="Market intelligence report with competitor analysis"
)

# Create coordinated squad
intelligence_squad = Squad(
    agents=[analyst, researcher],
    tasks=[analysis_task, research_task],
    process=Process.sequential,
    verbose=True
)

# Execute the orchestrated workflow
results = intelligence_squad.execute()
print(f"Analysis Complete: {results}")
```

### 🚀 Modern Orchestration (v2) - Dynamic & Intelligent

Ideal for **adaptive workflows**, **AI-driven decisions**, and **dynamic environments**.

```python
from jaygoga_orchestra.v2 import Agent, Team, Workflow

# Create intelligent agents with advanced capabilities
data_agent = Agent(
    name="JayGoga_DataSage",
    description="Advanced AI agent specialized in data analysis with deep learning capabilities",
    instructions="You are an expert data scientist with the ability to adapt your analysis approach based on data characteristics",
    model="gpt-4",
    tools=["python_interpreter", "data_visualization", "statistical_analysis"]
)

insight_agent = Agent(
    name="JayGoga_InsightMaster",
    description="Strategic insight generator with business acumen",
    instructions="Transform data findings into actionable business strategies and recommendations",
    model="claude-3-sonnet",
    tools=["business_analysis", "report_generation", "strategic_planning"]
)

# Create dynamic team with shared context
intelligence_team = Team(
    agents=[data_agent, insight_agent],
    name="Strategic Intelligence Unit",
    description="Elite team for comprehensive business intelligence",
    shared_memory=True,
    collaboration_mode="adaptive"
)


# Execute with dynamic adaptation
results = intelligence_team.run(
    task="Analyze our Q4 performance data and provide strategic recommendations for Q1",
    context={"data_source": "sales_db", "priority": "high", "deadline": "2024-01-15"}
)

print(f"Strategic Analysis: {results.summary}")
print(f"Key Insights: {results.insights}")
print(f"Recommendations: {results.recommendations}")
```

## 🏗️ Architecture Comparison

| Feature | Classical v1 | Modern v2 | Best For |
|---------|-------------|-----------|----------|
| **Structure** | Hierarchical, Role-based | Dynamic, Capability-based | v1: Enterprise, v2: Startups |
| **Execution** | Sequential/Parallel | Adaptive Intelligence | v1: Predictable, v2: Creative |
| **Memory** | Task-scoped | Shared Context | v1: Privacy, v2: Collaboration |
| **Scalability** | Linear | Exponential | v1: Controlled, v2: Rapid growth |
| **Learning** | Rule-based | AI-driven | v1: Compliance, v2: Innovation |
| **Complexity** | Structured | Self-organizing | v1: Governance, v2: Agility |

### 🎭 When to Choose Which Version

**Choose Classical v1 when:**
- 🏢 Enterprise environment with strict governance
- 📋 Well-defined, repeatable processes
- 🔒 Compliance and audit requirements
- 👥 Large teams with clear role definitions
- 📊 Predictable workflows and outcomes

**Choose Modern v2 when:**
- 🚀 Startup or innovation-focused environment
- 🧠 AI-driven decision making required
- 🔄 Dynamic, adaptive workflows needed
- 🌐 Collaborative, context-sharing scenarios
- 🎯 Creative problem-solving and exploration

## 📁 Project Structure

```
jaygoga_orchestra/
├── __init__.py          # Main orchestration entry point
├── v1/                  # Classical Orchestration (Structured)
│   ├── __init__.py      # Agent, Task, Squad, Process
│   ├── agent.py         # Role-based agents
│   ├── team.py          # Structured squads
│   ├── task.py          # Defined tasks
│   ├── process.py       # Execution processes
│   ├── cli/             # Command-line tools
│   ├── tools/           # Agent tools and utilities
│   └── ...
├── v2/                  # Modern Orchestration (Intelligent)
│   ├── __init__.py      # Agent, Team, Workflow
│   ├── agent/           # Intelligent agents
│   ├── team/            # Collaborative teams
│   ├── workflow/        # Dynamic workflows
│   ├── memory/          # Shared context
│   ├── reasoning/       # AI reasoning
│   └── ...
└── legacy/              # 🧪 Beta Features (Experimental)
    ├── README_BETA.md   # Beta documentation
    └── experimental/    # Cutting-edge features
```

## 🧪 Beta Features (Legacy/Experimental)

Our **legacy** directory contains experimental and beta features that showcase the future of AI orchestration:

```python
# 🚧 Beta Features - Available Soon!
from jaygoga_orchestra.legacy import ExperimentalAgent, AdvancedWorkflow

# Cutting-edge features in development
beta_agent = ExperimentalAgent(
    name="Krishna_BetaAgent",
    capabilities=["quantum_reasoning", "multi_dimensional_analysis"],
    status="beta"
)

# Advanced experimental workflows
experimental_flow = AdvancedWorkflow(
    name="Future_Intelligence",
    description="Next-generation AI orchestration patterns",
    beta_features=["auto_optimization", "self_healing", "predictive_scaling"]
)
```

**Beta Features Include:**
- 🔮 **Quantum Reasoning**: Advanced decision-making algorithms
- 🌊 **Self-Healing Workflows**: Automatic error recovery and optimization
- 🎯 **Predictive Scaling**: AI-driven resource management
- 🧠 **Neural Orchestration**: Brain-inspired coordination patterns
- ⚡ **Lightning Execution**: Ultra-fast processing capabilities

*These features are experimental and will be integrated into v3 in future releases.*

## 🔄 Migration & Integration

### 🎯 Getting Started with Govinda

```python
# Start with Classical v1 for structured workflows
from jaygoga_orchestra.v1 import Agent, Task, Squad, Process

# Upgrade to Modern v2 for intelligent orchestration
from jaygoga_orchestra.v2 import Agent, Team, Workflow

# Mix and match as needed
from jaygoga_orchestra.v1 import Task
from jaygoga_orchestra.v2 import Agent, Workflow
```

### 🚀 Advanced Usage Examples

**Multi-Agent Research Pipeline (v1):**
```python
from jaygoga_orchestra.v1 import Agent, Task, Squad, Process

# Create research squad
researcher = Agent(role="Research Specialist", goal="Gather comprehensive data")
analyst = Agent(role="Data Analyst", goal="Analyze and synthesize findings")
writer = Agent(role="Technical Writer", goal="Create detailed reports")

# Define research pipeline
tasks = [
    Task(description="Research AI trends in 2024", agent=researcher),
    Task(description="Analyze research findings", agent=analyst),
    Task(description="Write comprehensive report", agent=writer)
]

research_squad = Squad(agents=[researcher, analyst, writer], tasks=tasks)
report = research_squad.execute()
```

**Intelligent Content Creation (v2):**
```python
from jaygoga_orchestra.v2 import Agent, Team, Workflow

# Create intelligent content team
content_team = Team([
    Agent(name="ContentStrategist", model="gpt-4"),
    Agent(name="CreativeWriter", model="claude-3"),
    Agent(name="SEOOptimizer", model="gpt-3.5-turbo")
])

result = content_team.run("Create a viral blog post about AI trends")
```

## 🎨 Why JayGoga-Orchestra?

**JayGoga-Orchestra** represents the perfect harmony of AI agents working together like a well-conducted orchestra. Each agent plays its part while contributing to a greater symphony of intelligent automation.

**Core Principles:**
- 🎭 **Master Orchestration**: Seamlessly coordinates multiple agents
- 🧠 **Intelligent Coordination**: Smart decision-making and adaptation
- ⚡ **High Performance**: Efficient execution with elegant simplicity
- 🌟 **Universal Compatibility**: Works across all domains and use cases
- 🛡️ **Enterprise Reliability**: Robust error handling and fault tolerance

## 🤝 Community & Support

<!-- - 📚 **Documentation**: [docs.jaygoga.ai](https://docs.jaygoga.ai)
- 💬 **Discord**: [Join our community](https://discord.gg/jaygoga-orchestra) -->
- 🐛 **Issues**: [GitHub Issues](https://github.com/AIMLDev726/jaygoga_orchestra/issues)
- 📧 **Email**: aistudentlearn4@gmail.com

## 📜 License

MIT License - see LICENSE file for details.

## 🙏 Contributing

We welcome contributions from the community! Please read our contributing guidelines before submitting PRs.

---

**"Orchestrating AI agents in perfect harmony for intelligent automation."** 🎼
