🚀 Basic gRPC Service Documentation

Welcome to the Basic gRPC Service documentation! This is a modern Python gRPC service that showcases:

• 🔄 Bidirectional streaming with real-time chat
• ⚡ Async/await everywhere for performance
• 🎭 Background task orchestration with live updates
• ☁️ CloudEvents integration for event-driven architecture
• 🔐 TLS/SSL security with certificates
• 🏥 Health checks and reflection built-in

🎯 Quick Navigation

• Getting Started

  Jump right in with installation and setup instructions

• API Reference

  Complete documentation of all classes and methods

• Examples

  Code examples and usage patterns

• Development

  Contributing and development guidelines

🌟 Key Features

Real-time Communication

Our service supports bidirectional streaming, perfect for chat applications and real-time data feeds.

Background Processing

Demonstrate parallel task execution with the Background method - run multiple tasks and get live progress updates.

Enterprise Ready

Built with CloudEvents, structured logging, health checks, and graceful shutdown handling.

🔧 Architecture

graph TB
    Client[gRPC Client] -->|TLS/HTTP2| Server[gRPC Server]
    Server --> Hello[Hello Service<br/>Unary RPC]
    Server --> Talk[Talk Service<br/>Bidirectional Stream]
    Server --> Background[Background Service<br/>Server Stream]
    Talk --> Eliza[Eliza Chatbot]
    Background --> Workers[Background Workers]
    Server --> Health[Health Check]
    Server --> Reflection[Server Reflection]

Ready to dive in? Start with our Getting Started guide!