Skip to content

Versatile agents for long running, research intensive tasks.

License

Notifications You must be signed in to change notification settings

brainqub3/jar3d_meta_expert

Repository files navigation

Overview

Important Note

Jar3d has undergone a complete overhaul. The neo4j feature has been temporarily removed and will be reintroduced in a future release.

Supported Servers and Models

  • openai (Recommended)

    • Models:
      • gpt-4o-2024-08-06
      • gpt-4o-mini-2024-07-18
  • anthropic

    • Supported, but not recommended for use

About Jar3d

Jar3d is a Meta Agent built on LangGraph, designed to orchestrate a team of agents for completing basic tasks.

The agent team includes:

  • Google Search Agent
  • Google Shopping Agent
  • Web Scraper Agent
  • RAG Agent

The agent team can be extended by adding additional tool using agents to the project.

Important Note

If you are extending the agent team, you must have a meta_agent and a reporter_agent in the team.

Jar3d can perform basic tasks like product sourcing, writing newsletters, creating itineraries, and essentially anything that can be reasonably done with the team of agents listed above.

Table of Contents

  1. Core Concepts
  2. Prerequisites
  3. Configuration
  4. Setup
  5. Usage
  6. Roadmap
  7. Further Reading
  8. Integrations
  9. Features on the Roadmap

Core Concepts

Jar3d functions as a meta-agent system, orchestrating various agents to achieve complex goals. The system comprises four primary agent types:

  1. Meta Agent: Central orchestrator coordinating other agents' activities.
  2. Tool Agent: Interfaces with specific tools or services for specialized tasks.
  3. Reporter Agent: Communicates results and updates to the user.
  4. Requirements Gathering Agent: Refines and clarifies project requirements through user interaction.

Key Techniques

  • Meta Prompting: Leverages advanced prompting techniques for improved performance.
  • Chain of Reasoning: Adapts the Chain-of-Reasoning approach for more coherent outputs.
  • Retrieval Augmented Generation (RAG): Enhances responses with relevant contextual information.
  • Knowledge Graph Generation: Creates comprehensive knowledge graphs from web pages.

System Workflow

  1. Users interact with the Requirements Gathering Agent to define project goals.
  2. Finalized requirements are passed to the Meta Agent.
  3. The Meta Agent orchestrates Tool Agents to accomplish the goal.
  4. Results are passed to the Reporter Agent for user communication.

Workflow Diagram

graph TD
    A[Start] --> B[Requirements Gathering]
    B --> C{Requirements Met?}
    C -->|No| B
    C -->|Yes| D[Pass Requirements to Meta Agent]
    D --> E[Meta Agent Selects Agent from Registry]
    E --> F[Selected Agent Processes Query]
    F --> G[Agent Reports Back to Meta Agent]
    G --> H{Meta Agent: Task Complete?}
    H -->|No| E
    H -->|Yes| I[Meta Agent Prepares Final Response]
    I --> J[Reporter Agent Receives Response]
    J --> K[Reporter Agent Reports to User]
    K --> L[End]
Loading

Prerequisites

  1. Git
  2. Docker and Docker Compose

Configuration

  1. Clone the repository:

    git clone https://github.com/brainqub3/meta_expert.git
    cd meta_expert
  2. Configure config/config.yaml:

    • Set API keys for chosen LLM providers (Serper, OpenAI, Gemini, Claude, Groq)
    • Choose inference provider by setting LLM_SERVER (e.g., claude, openai, groq)

Note: Keep your config.yaml file private as it contains sensitive information.

Setup

Confgurations

Setup the configurations for the project in the config/config.yaml file.

Docker Setup

  1. Ensure Docker daemon is running.
  2. Build and start containers:
    docker-compose up --build
  3. Access Jar3d web interface at http://localhost:8105.

To stop the service:

docker-compose down

Usage

  1. Access the Jar3d web interface.
  2. Jar3d will introduce itself and ask questions to refine your requirements.
  3. Type /end when you've provided all relevant information.
  4. Submit feedback using the /feedback tag.

Roadmap

  • Integration with Ollama, vLLM, and other LLM providers
  • Enhanced memory management
  • Improved document processing and RAG capabilities

Further Reading

To deepen your understanding of the concepts and technologies used in Jar3d, we recommend the following resources:

For the latest updates and detailed documentation, please refer to our GitHub repository.

Integrations

  • Jar3d integrates with LangSmith for observability.
    • Monitor flows through the agent graph.
    • Debug applications.

Features on the Roadmap

  • Memory management
  • Support for Ollama
  • Support for vLLM
  • Support for Gemini
  • Support for Groq
  • Support for Mistral
  • Include Google Places and Maps Agents
  • Include Neo4J Graph Agent Generator