VCPToolBox  by lioensky

A versatile AI agent framework for advanced tool interaction and evolution

Created 5 months ago
373 stars

Top 76.0% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

VCPToolBox is a next-generation AI middleware and toolbox empowering AI agents with enhanced capabilities, persistent memory, and collaborative intelligence. It integrates AI reasoning, external tools, and memory for autonomous learning, evolution, and collaboration, ideal for building complex, evolving AI applications beyond simple prompt-response.

How It Works

VCP acts as a flexible, plugin-based intermediary using the Variable & Command Protocol (VCP) for AI-friendly tool invocation, memory management, and service interaction. Key features include an extensible plugin system (sync, async, service), a centralized WebSocket backbone, AI-driven persistent memory with vector databases, multimodal data handling, and distributed deployment. It also supports specialized model API bypass.

Quick Start & Requirements

  • Installation: Clone (git clone), install Node.js (npm install) and Python (pip install -r requirements.txt) dependencies.
  • Configuration: Copy config.env.example to config.env and populate API keys, URLs, ports.
  • Running: Start with node server.js. Docker Compose (docker-compose up --build -d) recommended.
  • Prerequisites: Node.js, Python environment with pip. Docker/Docker Compose.
  • Distributed Nodes: Requires separate VCPDistributedServer setup.
  • Links: GitHub Repository, VCPDistributedServer.

Highlighted Details

  • Asynchronous Task Handling: Enables non-blocking initiation of long-running tasks (e.g., video generation) with intermediate updates via placeholders.
  • Persistent Memory & RAG: AI-driven memory with advanced RAG, time-aware/semantic group retrieval, and self-learning.
  • Distributed Architecture: Scales compute across multiple nodes for enhanced performance and specialized tasks.
  • Multimodal Support: Handles various data types (Base64, files) and enables cross-modal translation.
  • VCPTavern: Visual context injector for fine-grained AI behavior control.
  • Human-Facing Tool Endpoint: Allows direct, AI-less tool invocation via API.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels. Further information is likely available on the project's GitHub page.

Licensing & Compatibility

  • License: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).
  • Restrictions: Prohibits commercial use; derivative works must be shared under the same license.

Limitations & Caveats

The project is in active development and may contain errors. Commercial use is prohibited. Users are responsible for third-party API costs. Distributed nodes currently support only synchronous stdio plugins. A strong warning is issued against using unofficial API proxies due to security risks.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
10
Issues (30d)
15
Star History
220 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.