| Name | mcmoya JSON |
| Version |
0.1.2
JSON |
| download |
| home_page | https://github.com/yourusername/mcmoya |
| Summary | A reference implementation of the Moya AI framework. |
| upload_time | 2025-02-10 12:53:02 |
| maintainer | None |
| docs_url | None |
| author | hiname |
| requires_python | >=3.8 |
| license | MIT License
Copyright (c) 2025 MontyCloud
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
| keywords |
python
moya
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# MOYA - Meta Orchestration framework for Your Agents
MOYA is a reference implementation of our research paper titled "Engineering LLM Powered Multi-agent Framework for Autonomous CloudOps". The framework provides a flexible and extensible architecture for creating, managing, and orchestrating multiple AI agents to handle various tasks autonomously.
Preprint of the paper can be accessed at [arXiv](https://arxiv.org/abs/2501.08243).
## Features
- **Agent Management**: Create, register, and manage multiple AI agents.
- **Orchestration**: Orchestrate conversations and tasks across multiple agents.
- **Memory Tools**: Integrate memory tools to maintain conversation context and history.
- **Streaming Responses**: Support for streaming responses from agents.
- **Extensibility**: Easily extend the framework with new agents, tools, and orchestrators.
## Getting Started
### Prerequisites
- Python 3.10+
- Install required dependencies:
```bash
pip install .
```
### Quick Start Examples
#### OpenAI Agent
Interactive chat example using OpenAI agent with conversation memory.
```python
# filepath: /Users/kannan/src/github/moya/examples/quick_start_openai.py
python -m examples.quick_start_openai
```
#### Bedrock Agent
Interactive chat example using BedrockAgent with conversation memory.
```python
# filepath: /Users/kannan/src/github/moya/examples/quick_start_bedrock.py
AWS_PROFILE=my_profile_name python -m examples.quick_start_bedrock
```
#### Multi-Agent Orchestration
Example demonstrating multi-agent orchestration with language and task classification.
```python
# filepath: /Users/kannan/src/github/moya/examples/quick_start_multiagent.py
python -m examples.quick_start_multiagent
```
#### Dynamic Agent Creation
Example demonstrating dynamic agent creation and registration during runtime.
```python
# filepath: /Users/kannan/src/github/moya/examples/dynamic_agents.py
python -m examples.dynamic_agents
```
### Directory Structure
```
moya/
├── agents/ # Agent implementations (OpenAI, Bedrock, Ollama, Remote)
├── classifiers/ # Classifier implementations for agent selection
├── memory/ # Memory repository implementations
├── orchestrators/ # Orchestrator implementations for managing agent interactions
├── registry/ # Agent registry and repository implementations
├── tools/ # Tool implementations (e.g., MemoryTool)
├── examples/ # Example scripts demonstrating various use cases
└── README.md # This README file
```
### Contributing
We welcome contributions to the MOYA framework. Please follow these steps to contribute:
1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Make your changes and commit them with descriptive messages.
4. Push your changes to your fork.
5. Create a pull request to the main repository.
### License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
### Contact
For any questions or inquiries, please contact the authors of the research paper or open an issue on the GitHub repository.
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/mcmoya",
"name": "mcmoya",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "python, moya",
"author": "hiname",
"author_email": "MontyCloud <kannan@montycloud.com>",
"download_url": "https://files.pythonhosted.org/packages/96/21/808caafc6e1848be97e1954f67625efe77da5a9e49be9b2dbfa23092ffdc/mcmoya-0.1.2.tar.gz",
"platform": null,
"description": "# MOYA - Meta Orchestration framework for Your Agents\r\n\r\nMOYA is a reference implementation of our research paper titled \"Engineering LLM Powered Multi-agent Framework for Autonomous CloudOps\". The framework provides a flexible and extensible architecture for creating, managing, and orchestrating multiple AI agents to handle various tasks autonomously.\r\n\r\nPreprint of the paper can be accessed at [arXiv](https://arxiv.org/abs/2501.08243).\r\n\r\n## Features\r\n\r\n- **Agent Management**: Create, register, and manage multiple AI agents.\r\n- **Orchestration**: Orchestrate conversations and tasks across multiple agents.\r\n- **Memory Tools**: Integrate memory tools to maintain conversation context and history.\r\n- **Streaming Responses**: Support for streaming responses from agents.\r\n- **Extensibility**: Easily extend the framework with new agents, tools, and orchestrators.\r\n\r\n## Getting Started\r\n\r\n### Prerequisites\r\n\r\n- Python 3.10+\r\n- Install required dependencies:\r\n ```bash\r\n pip install .\r\n ```\r\n\r\n### Quick Start Examples\r\n\r\n#### OpenAI Agent\r\n\r\nInteractive chat example using OpenAI agent with conversation memory.\r\n\r\n```python\r\n# filepath: /Users/kannan/src/github/moya/examples/quick_start_openai.py\r\n\r\npython -m examples.quick_start_openai\r\n\r\n```\r\n\r\n#### Bedrock Agent\r\n\r\nInteractive chat example using BedrockAgent with conversation memory.\r\n\r\n```python\r\n# filepath: /Users/kannan/src/github/moya/examples/quick_start_bedrock.py\r\n\r\nAWS_PROFILE=my_profile_name python -m examples.quick_start_bedrock\r\n```\r\n\r\n#### Multi-Agent Orchestration\r\n\r\nExample demonstrating multi-agent orchestration with language and task classification.\r\n\r\n```python\r\n# filepath: /Users/kannan/src/github/moya/examples/quick_start_multiagent.py\r\n\r\npython -m examples.quick_start_multiagent\r\n```\r\n\r\n#### Dynamic Agent Creation\r\n\r\nExample demonstrating dynamic agent creation and registration during runtime.\r\n\r\n\r\n```python\r\n# filepath: /Users/kannan/src/github/moya/examples/dynamic_agents.py\r\n\r\n\r\npython -m examples.dynamic_agents\r\n```\r\n\r\n### Directory Structure\r\n\r\n```\r\nmoya/\r\n\u251c\u2500\u2500 agents/ # Agent implementations (OpenAI, Bedrock, Ollama, Remote)\r\n\u251c\u2500\u2500 classifiers/ # Classifier implementations for agent selection\r\n\u251c\u2500\u2500 memory/ # Memory repository implementations\r\n\u251c\u2500\u2500 orchestrators/ # Orchestrator implementations for managing agent interactions\r\n\u251c\u2500\u2500 registry/ # Agent registry and repository implementations\r\n\u251c\u2500\u2500 tools/ # Tool implementations (e.g., MemoryTool)\r\n\u251c\u2500\u2500 examples/ # Example scripts demonstrating various use cases\r\n\u2514\u2500\u2500 README.md # This README file\r\n```\r\n\r\n### Contributing\r\n\r\nWe welcome contributions to the MOYA framework. Please follow these steps to contribute:\r\n\r\n1. Fork the repository.\r\n2. Create a new branch for your feature or bugfix.\r\n3. Make your changes and commit them with descriptive messages.\r\n4. Push your changes to your fork.\r\n5. Create a pull request to the main repository.\r\n\r\n### License\r\n\r\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\r\n\r\n### Contact\r\n\r\nFor any questions or inquiries, please contact the authors of the research paper or open an issue on the GitHub repository.\r\n",
"bugtrack_url": null,
"license": "MIT License\r\n \r\n Copyright (c) 2025 MontyCloud \r\n \r\n Permission is hereby granted, free of charge, to any person obtaining a copy\r\n of this software and associated documentation files (the \"Software\"), to deal\r\n in the Software without restriction, including without limitation the rights\r\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n copies of the Software, and to permit persons to whom the Software is\r\n furnished to do so, subject to the following conditions:\r\n \r\n The above copyright notice and this permission notice shall be included in all\r\n copies or substantial portions of the Software.\r\n \r\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\r\n ",
"summary": "A reference implementation of the Moya AI framework.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/yourusername/mcmoya"
},
"split_keywords": [
"python",
" moya"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c8a72c75c1a21f8f33c6b3a592d2f748d91c6533ecfff653ba51a0f2d24b828b",
"md5": "822791b39148d0c8ae2a9fa04b2422df",
"sha256": "fc2b46730c9898c45c0d7e0275bfd36ce4212d7551d930f3703c44d83d1b4e7f"
},
"downloads": -1,
"filename": "mcmoya-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "822791b39148d0c8ae2a9fa04b2422df",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 30223,
"upload_time": "2025-02-10T12:53:00",
"upload_time_iso_8601": "2025-02-10T12:53:00.664308Z",
"url": "https://files.pythonhosted.org/packages/c8/a7/2c75c1a21f8f33c6b3a592d2f748d91c6533ecfff653ba51a0f2d24b828b/mcmoya-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9621808caafc6e1848be97e1954f67625efe77da5a9e49be9b2dbfa23092ffdc",
"md5": "c551d604ffae1d6bcf4d8d3b869cfd15",
"sha256": "a1c7cdf4f7009135947e5e5432e5713284e72c715bfbddb111e168882617091c"
},
"downloads": -1,
"filename": "mcmoya-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "c551d604ffae1d6bcf4d8d3b869cfd15",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 19608,
"upload_time": "2025-02-10T12:53:02",
"upload_time_iso_8601": "2025-02-10T12:53:02.035509Z",
"url": "https://files.pythonhosted.org/packages/96/21/808caafc6e1848be97e1954f67625efe77da5a9e49be9b2dbfa23092ffdc/mcmoya-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-10 12:53:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "mcmoya",
"github_not_found": true,
"lcname": "mcmoya"
}
