8000 GitHub - tnbtinai/muvio-a2a-framework: Muvius is a powerful framework for building and managing AI agents with advanced memory systems and seamless inter-agent communication. It provides a structured approach to creating intelligent agents
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Muvius is a powerful framework for building and managing AI agents with advanced memory systems and seamless inter-agent communication. It provides a structured approach to creating intelligent agents

License

Notifications You must be signed in to change notification settings

tnbtinai/muvio-a2a-framework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Muvius Framework

Muvius Framework Logo

A G E N T - T O - A G E N T
I N T E L L I G E N C E

by MUVIO AI

What is Muvius?

Muvius is a powerful framework for building and managing AI agents with advanced memory systems and seamless inter-agent communication. It provides a structured approach to creating intelligent agents that can:

  • Maintain context through multiple memory systems
  • Communicate with other agents using standardized protocols
  • Handle complex tasks through role-based interactions
  • Scale from simple to complex multi-agent systems

Key Features

1. Memory Systems

  • Episodic Memory: Tracks conversation history and interactions
  • Procedural Memory: Stores agent roles, rules, and procedures
  • Vector Store: Enables semantic search and context understanding

2. Agent Communication

  • Standardized message protocols
  • Dynamic message routing
  • Inter-agent collaboration support

3. Easy Integration

  • FastAPI-based REST endpoints
  • Docker support for easy deployment
  • CLI tools for quick setup and management

Architecture

┌─────────────────────────────────────────────────────────┐
│                     Muvius Framework                    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐  │
│  │ Orchestrator│    │   Agents    │    │   Shared    │  │
│  │             │    │             │    │ Services    │  │
│  └──────┬──────┘    └──────┬──────┘    └──────┬──────┘  │
│         │                  │                  │         │
│  ┌──────▼──────┐    ┌──────▼──────┐    ┌──────▼──────┐  │
│  │  Message    │    │  Memory     │    │  Utilities  │  │
│  │  Routing    │    │  Systems    │    │  & Tools    │  │
│  └─────────────┘    └─────────────┘    └─────────────┘  │
│                                                         │
└─────────────────────────────────────────────────────────┘

Quick Start

1. Installation

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate

# Install Muvius
pip install muvius

2. Initialize Your Project

# Create a new Muvius project
muvius init

# Create your first agent
muvius create-agent my-agent

3. Start Development

# Start the orchestrator
python -m muvius.orchestrator.main

# Start your agent (in a new terminal)
python -m muvius.agents.my-agent.main

Project Structure

muvius/
├── agents/              # Agent modules
│   └── my-agent/       # Your custom agent
│       ├── memory/     # Memory systems
│       ├── main.py     # Agent logic
│       └── routes.py   # API endpoints
├── orchestrator/       # Message routing
└── shared/            # Common utilities

CLI Commands

# Initialize framework
muvius init

# Create new agent
muvius create-agent <agent-name>

# Delete agent
muvius delete-agent <agent-name>

Memory Systems

Episodic Memory

  • SQLite-based conversation history
  • Automatic message logging
  • Context retrieval for conversations

Procedural Memory

  • YAML-based configuration
  • Role and policy definitions
  • Procedure storage and retrieval

Vector Store

  • Semantic search capabilities
  • Context understanding
  • Long-term memory storage

API Endpoints

Orchestrator

  • POST /process-message: Route messages to agents
  • GET /ping: Health check

Agents

  • POST /interact: Handle agent interactions
  • GET /ping: Health check

Development

Prerequisites

  • Python 3.8+
  • pip
  • virtualenv

Environment Setup

  1. Create .env file:
OPENAI_API_KEY=your_api_key_here

Running Tests

pytest

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License

MIT License

Support

For support, please:

  1. Check the documentation
  2. Open an issue on GitHub
  3. Contact the Muvio AI team

Built with ❤️ by @varun-singhh

About

Muvius is a powerful framework for building and managing AI agents with advanced memory systems and seamless inter-agent communication. It provides a structured approach to creating intelligent agents

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

0