mirror of https://github.com/trustgraph-ai/trustgraph.git synced 2026-04-25 16:36:21 +02:00

* Bump setup.py versions for 1.1

* PoC MCP server (#419)

* Very initial MCP server PoC for TrustGraph

* Put service on port 8000

* Add MCP container and packages to buildout

* Update docs for API/CLI changes in 1.0 (#421)

* Update some API basics for the 0.23/1.0 API change

* Add MCP container push (#425)

* Add command args to the MCP server (#426)

* Host and port parameters

* Added websocket arg

* More docs

* MCP client support (#427)

- MCP client service
- Tool request/response schema
- API gateway support for mcp-tool
- Message translation for tool request & response
- Make mcp-tool using configuration service for information
  about where the MCP services are.

* Feature/react call mcp (#428)

Key Features

  - MCP Tool Integration: Added core MCP tool support with ToolClientSpec and ToolClient classes
  - API Enhancement: New mcp_tool method for flow-specific tool invocation
  - CLI Tooling: New tg-invoke-mcp-tool command for testing MCP integration
  - React Agent Enhancement: Fixed and improved multi-tool invocation capabilities
  - Tool Management: Enhanced CLI for tool configuration and management

Changes

  - Added MCP tool invocation to API with flow-specific integration
  - Implemented ToolClientSpec and ToolClient for tool call handling
  - Updated agent-manager-react to invoke MCP tools with configurable types
  - Enhanced CLI with new commands and improved help text
  - Added comprehensive documentation for new CLI commands
  - Improved tool configuration management

Testing

  - Added tg-invoke-mcp-tool CLI command for isolated MCP integration testing
  - Enhanced agent capability to invoke multiple tools simultaneously

* Test suite executed from CI pipeline (#433)

* Test strategy & test cases

* Unit tests

* Integration tests

* Extending test coverage (#434)

* Contract tests

* Testing embeedings

* Agent unit tests

* Knowledge pipeline tests

* Turn on contract tests

* Increase storage test coverage (#435)

* Fixing storage and adding tests

* PR pipeline only runs quick tests

* Empty configuration is returned as empty list, previously was not in response (#436)

* Update config util to take files as well as command-line text (#437)

* Updated CLI invocation and config model for tools and mcp (#438)

* Updated CLI invocation and config model for tools and mcp

* CLI anomalies

* Tweaked the MCP tool implementation for new model

* Update agent implementation to match the new model

* Fix agent tools, now all tested

* Fixed integration tests

* Fix MCP delete tool params

* Update Python deps to 1.2

* Update to enable knowledge extraction using the agent framework (#439)

* Implement KG extraction agent (kg-extract-agent)

* Using ReAct framework (agent-manager-react)
 
* ReAct manager had an issue when emitting JSON, which conflicts which ReAct manager's own JSON messages, so refactored ReAct manager to use traditional ReAct messages, non-JSON structure.
 
* Minor refactor to take the prompt template client out of prompt-template so it can be more readily used by other modules. kg-extract-agent uses this framework.

* Migrate from setup.py to pyproject.toml (#440)

* Converted setup.py to pyproject.toml

* Modern package infrastructure as recommended by py docs

* Install missing build deps (#441)

* Install missing build deps (#442)

* Implement logging strategy (#444)

* Logging strategy and convert all prints() to logging invocations

* Fix/startup failure (#445)

* Fix loggin startup problems

* Fix logging startup problems (#446)

* Fix logging startup problems (#447)

* Fixed Mistral OCR to use current API (#448)

* Fixed Mistral OCR to use current API

* Added PDF decoder tests

* Fix Mistral OCR ident to be standard pdf-decoder (#450)

* Fix Mistral OCR ident to be standard pdf-decoder

* Correct test

* Schema structure refactor (#451)

* Write schema refactor spec

* Implemented schema refactor spec

* Structure data mvp (#452)

* Structured data tech spec

* Architecture principles

* New schemas

* Updated schemas and specs

* Object extractor

* Add .coveragerc

* New tests

* Cassandra object storage

* Trying to object extraction working, issues exist

* Validate librarian collection (#453)

* Fix token chunker, broken API invocation (#454)

* Fix token chunker, broken API invocation (#455)

* Knowledge load utility CLI (#456)

* Knowledge loader

* More tests

2025-08-18 20:56:09 +01:00

2.4 KiB

Raw Blame History

Quick Test Setup Guide

TL;DR - Just Run This

# From the trustgraph project root directory
./run_tests.sh

This script will:

Check current imports
Install all required TrustGraph packages
Install test dependencies
Run the VertexAI tests

If You Get Import Errors

The most common issue is that TrustGraph packages aren't installed. Here's how to fix it:

Step 1: Check What's Missing

./check_imports.py

Step 2: Install TrustGraph Packages

./install_packages.sh

Step 3: Verify Installation

./check_imports.py

Step 4: Run Tests

pytest tests/unit/test_text_completion/test_vertexai_processor.py -v

What the Scripts Do

`check_imports.py`

Tests all the imports needed for the tests
Shows exactly what's missing
Helps diagnose import issues

`install_packages.sh`

Installs trustgraph-base (required by others)
Installs trustgraph-cli
Installs trustgraph-vertexai
Installs trustgraph-flow
Uses pip install -e . for editable installs

`run_tests.sh`

Runs all the above steps in order
Installs test dependencies
Runs the VertexAI tests
Shows clear output at each step

Manual Installation (If Scripts Don't Work)

# Install packages in order (base first!)
cd trustgraph-base && pip install -e . && cd ..
cd trustgraph-cli && pip install -e . && cd ..
cd trustgraph-vertexai && pip install -e . && cd ..
cd trustgraph-flow && pip install -e . && cd ..

# Install test dependencies
cd tests && pip install -r requirements.txt && cd ..

# Run tests
pytest tests/unit/test_text_completion/test_vertexai_processor.py -v

Common Issues

"No module named 'trustgraph'" → Run ./install_packages.sh
"No module named 'trustgraph.base'" → Install trustgraph-base first
"No module named 'trustgraph.model.text_completion.vertexai'" → Install trustgraph-vertexai
Scripts not executable → Run chmod +x *.sh
Wrong directory → Make sure you're in the project root (where README.md is)

Test Results

When working correctly, you should see:

✅ All imports successful
139 test cases running
Tests passing (or failing for logical reasons, not import errors)

Getting Help

If you're still having issues:

Share the output of ./check_imports.py
Share the exact error message
Confirm you're in the right directory: /home/mark/work/trustgraph.ai/trustgraph

2.4 KiB Raw Blame History