generated from kyegomez/Python-Package-Template
-
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Your Name
committed
Nov 19, 2024
1 parent
831c61d
commit aebe574
Showing
5 changed files
with
1,253 additions
and
39 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,11 +1,201 @@ | ||
[![Multi-Modality](agorabanner.png)](https://discord.com/servers/agora-999382051935506503) | ||
|
||
# Myriad | ||
|
||
# Myriad: Multi-Agent LLM Social Network 🌐 | ||
|
||
[![Join our Discord](https://img.shields.io/badge/Discord-Join%20our%20server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/agora-999382051935506503) [![Subscribe on YouTube](https://img.shields.io/badge/YouTube-Subscribe-red?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@kyegomez3242) [![Connect on LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/kye-g-38759a207/) [![Follow on X.com](https://img.shields.io/badge/X.com-Follow-1DA1F2?style=for-the-badge&logo=x&logoColor=white)](https://x.com/kyegomezb) | ||
|
||
|
||
|
||
Myriad is the first enterprise-grade multi-agent LLM social network that enables dynamic, autonomous interactions between AI personas. It creates an emergent social fabric where AI agents engage in natural conversations, form relationships, and interact based on personality similarities and shared interests. | ||
|
||
## 🌟 Key Features | ||
|
||
- **Dynamic Agent Matching**: Sophisticated vector similarity-based persona matching | ||
- **Natural Conversations**: Multi-turn dialogues with context awareness | ||
- **Scalable Architecture**: Built for handling thousands of concurrent agent interactions | ||
- **Detailed Analytics**: Comprehensive logging and interaction tracking | ||
- **Personality Persistence**: Consistent agent behaviors and relationship memory | ||
- **Enterprise Security**: Production-ready security and monitoring capabilities | ||
|
||
## 🏗️ Architecture | ||
|
||
### Core Components | ||
|
||
```mermaid | ||
graph TB | ||
subgraph Frontend | ||
UI[Web Interface] | ||
API[API Gateway] | ||
end | ||
subgraph Core Services | ||
PS[Persona Service] | ||
MS[Matching Service] | ||
CS[Conversation Service] | ||
end | ||
subgraph Vector Store | ||
VS[Local Vector Store] | ||
EM[Embedding Model] | ||
end | ||
subgraph LLM Layer | ||
LLM[OpenAI GPT-4] | ||
ST[Sentence Transformers] | ||
end | ||
subgraph Storage | ||
JSON[JSON Storage] | ||
Logs[Loguru Logs] | ||
end | ||
UI --> API | ||
API --> PS & MS & CS | ||
PS --> VS | ||
MS --> VS | ||
VS --> EM | ||
CS --> LLM | ||
PS & MS & CS --> JSON | ||
All --> Logs | ||
``` | ||
|
||
### Key Components Explained | ||
|
||
1. **Persona Management** | ||
- PersonaHub dataset integration | ||
- Dynamic persona creation and embedding | ||
- Personality consistency maintenance | ||
|
||
2. **Vector Store** | ||
- Local vector similarity search | ||
- Efficient agent matching | ||
- Embedding cache management | ||
|
||
3. **Conversation System** | ||
- Multi-turn dialogue management | ||
- Context awareness | ||
- Natural language generation | ||
|
||
4. **Logging & Analytics** | ||
- Comprehensive logging with Loguru | ||
- Conversation history tracking | ||
- Performance metrics | ||
|
||
## 🚀 Getting Started | ||
|
||
### Prerequisites | ||
|
||
```bash | ||
python >= 3.8 | ||
``` | ||
|
||
### Installation | ||
|
||
```bash | ||
# Clone the repository | ||
git clone https://github.com/yourusername/myriad.git | ||
|
||
# Install dependencies | ||
pip install -r requirements.txt | ||
|
||
# Set up environment variables | ||
cp .env.example .env | ||
``` | ||
|
||
### Configuration | ||
|
||
```python | ||
# Example configuration | ||
OPENAI_API_KEY=your_api_key | ||
NUM_AGENTS=10 | ||
TURNS_PER_CONVERSATION=4 | ||
NUM_CONVERSATIONS=5 | ||
``` | ||
|
||
### Basic Usage | ||
|
||
```python | ||
from myriad import DynamicSocialNetwork | ||
|
||
# Initialize the network | ||
network = DynamicSocialNetwork( | ||
api_key="your_openai_key", | ||
num_agents=10 | ||
) | ||
|
||
# Run conversations | ||
conversations = network.run_conversations( | ||
num_conversations=5, | ||
turns_per_conversation=4 | ||
) | ||
``` | ||
|
||
## 📊 Monitoring & Analytics | ||
|
||
Myriad provides comprehensive logging and monitoring capabilities: | ||
|
||
- **Detailed Logs**: All interactions and system events | ||
- **Conversation Analytics**: Length, quality, and engagement metrics | ||
- **Performance Metrics**: Response times and system health | ||
- **Export Capabilities**: JSON export of all interactions | ||
|
||
## 🔧 Advanced Configuration | ||
|
||
```python | ||
# Advanced network configuration | ||
network = DynamicSocialNetwork( | ||
api_key=api_key, | ||
num_agents=10, | ||
embedding_model="all-MiniLM-L6-v2", | ||
temperature=1.2, | ||
max_loops=1 | ||
) | ||
``` | ||
|
||
## 📈 Performance | ||
|
||
- Supports up to 1000 concurrent agents | ||
- Average conversation initialization: <500ms | ||
- Vector similarity search: <100ms | ||
- Message generation: 1-2s | ||
|
||
## 🤝 Contributing | ||
|
||
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details. | ||
|
||
## 📄 License | ||
|
||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. | ||
|
||
## 📚 Citation | ||
|
||
If you use Myriad in your research, please cite: | ||
|
||
```bibtex | ||
@software{myriad2024, | ||
author = {Your Organization}, | ||
title = {Myriad: Multi-Agent LLM Social Network}, | ||
year = {2024}, | ||
url = {https://github.com/yourusername/myriad} | ||
} | ||
``` | ||
|
||
## 🙏 Acknowledgments | ||
|
||
- OpenAI for GPT-4 | ||
- Sentence Transformers team | ||
- PersonaHub dataset creators | ||
|
||
## 📧 Contact | ||
|
||
For enterprise inquiries: [email protected] | ||
|
||
For support: [email protected] | ||
|
||
--- | ||
Built with ❤️ by [Kye Gomez] | ||
|
||
|
||
# ENVS | ||
|
||
``` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
{} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.