mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-07-21 19:21:03 +02:00
89 lines
4.3 KiB
Markdown
89 lines
4.3 KiB
Markdown
# TrustGraph Documentation
|
|
|
|
Welcome to the TrustGraph documentation. This directory contains comprehensive guides for using TrustGraph's APIs and command-line tools.
|
|
|
|
## Documentation Overview
|
|
|
|
### 📚 [API Documentation](apis/README.md)
|
|
Complete reference for TrustGraph's APIs, including REST, WebSocket, Pulsar, and Python SDK interfaces. Learn how to integrate TrustGraph services into your applications.
|
|
|
|
### 🖥️ [CLI Documentation](cli/README.md)
|
|
Comprehensive guide to TrustGraph's command-line interface. Includes detailed documentation for all CLI commands, from system administration to knowledge graph management.
|
|
|
|
### 🚀 [Quick Start Guide](README.quickstart-docker-compose.md)
|
|
Step-by-step guide to get TrustGraph running using Docker Compose. Perfect for first-time users who want to quickly deploy and test TrustGraph.
|
|
|
|
## Getting Started
|
|
|
|
If you're new to TrustGraph, we recommend starting with the
|
|
[Compose - Quick Start Guide](README.quickstart-docker-compose.md)
|
|
to get a working system up and running quickly.
|
|
|
|
For developers integrating TrustGraph into applications, check out the
|
|
[API Documentation](apis/README.md) to understand the available interfaces.
|
|
|
|
For system administrators and power users, the
|
|
[CLI Documentation](cli/README.md) provides detailed information about all
|
|
command-line tools.
|
|
|
|
## Ways to deploy
|
|
|
|
If you haven't deployed TrustGraph before, the 'compose' deployment
|
|
mentioned above is going to be the least commitment of setting things up:
|
|
See [Quick Start Guide](README.quickstart-docker-compose.md)
|
|
|
|
Other deployment mechanisms include:
|
|
- [Scaleway Kubernetes deployment using Pulumi](https://github.com/trustgraph-ai/pulumi-trustgraph-scaleway)
|
|
- [Intel Gaudi and GPU](https://github.com/trustgraph-ai/trustgraph-tiber-cloud) - tested on Intel Tiber cloud
|
|
- [Azure Kubernetes deployment using Pulumi](https://github.com/trustgraph-ai/pulumi-trustgraph-aks)
|
|
- [AWS EC2 single instance deployment using Pulumi](https://github.com/trustgraph-ai/pulumi-trustgraph-ec2)
|
|
- [GCP GKE cloud deployment using Pulumi](https://github.com/trustgraph-ai/pulumi-trustgraph-gke)
|
|
- [RKE Kubernetes on AWS deployment using Pulumi](https://github.com/trustgraph-ai/pulumi-trustgraph-aws-rke)
|
|
- It should be possible to deploy on AWS EKS, but we haven't been able to
|
|
script anything reliable so far.
|
|
|
|
## What is TrustGraph?
|
|
|
|
TrustGraph is a comprehensive knowledge graph and retrieval-augmented generation (RAG) platform that enables:
|
|
|
|
- **Knowledge Extraction**: Extract structured knowledge from documents and text
|
|
- **Graph RAG**: Advanced retrieval-augmented generation using knowledge graphs
|
|
- **Multi-Model Support**: Integration with various AI models (OpenAI, Claude, Ollama, etc.)
|
|
- **Scalable Architecture**: Built on Apache Pulsar for high-performance processing
|
|
- **Flexible Deployment**: Docker Compose files for various configurations
|
|
|
|
## Key Features
|
|
|
|
- **Graph-Based Knowledge Representation**: Store and query knowledge as interconnected graphs
|
|
- **Document Processing**: Extract knowledge from PDFs, text files, and other documents
|
|
- **Agent-Based Interactions**: Conversational AI with access to knowledge graphs
|
|
- **Multi-Modal APIs**: REST, WebSocket, Pulsar, and Python SDK interfaces
|
|
- **Comprehensive CLI**: Command-line tools for all operations
|
|
- **Monitoring & Observability**: Built-in metrics and monitoring capabilities
|
|
|
|
## Architecture
|
|
|
|
TrustGraph consists of several key components:
|
|
|
|
- **Processing Pipeline**: Document ingestion, chunking, vectorization, and knowledge extraction
|
|
- **Storage Systems**: Vector databases, graph databases (Neo4j/Cassandra), and document storage
|
|
- **AI Services**: Text completion, embeddings, and specialized processing services
|
|
- **API Gateway**: REST and WebSocket interfaces for external integration
|
|
- **Message System**: Apache Pulsar for reliable, scalable message processing
|
|
|
|
## Support
|
|
|
|
For questions, issues, or contributions:
|
|
|
|
- **GitHub Issues**: Report bugs and feature requests
|
|
- **Documentation**: This documentation covers most use cases
|
|
- **Community**: Join discussions and share experiences
|
|
|
|
## Related Resources
|
|
|
|
- [TrustGraph GitHub Repository](https://github.com/trustgraph-ai/trustgraph)
|
|
- [Docker Hub Images](https://hub.docker.com/u/trustgraph)
|
|
- [Example Notebooks](https://github.com/trustgraph-ai/example-notebooks) -
|
|
shows some example use of various APIs.
|
|
|
|
|