Skip to content

Explanation

This section provides background and context to deepen your understanding of Nauyaca and the Gemini protocol. While tutorials teach you how to use Nauyaca and references describe what it does, these explanations illuminate the "why" behind design decisions, protocols, and architectures.

Purpose of This Section

Explanation documentation helps you:

  • Understand the principles behind Nauyaca's architecture
  • Make informed decisions about how to use the library
  • Troubleshoot issues by understanding underlying mechanisms
  • Evaluate whether Nauyaca is right for your use case

Topics

  • Gemini Protocol

    Learn about the Gemini protocol specification, its design philosophy, and how it differs from HTTP. Understand the simplicity that makes Gemini unique.

    Learn about Gemini

  • Architecture

    Explore how Nauyaca is designed using Python's asyncio Protocol/Transport pattern. Understand the module structure and core design decisions.

    Explore architecture

  • Security Model

    Understand Nauyaca's security approach, including TOFU (Trust On First Use) validation, rate limiting, and other protective measures.

    Understand security

How to Use This Section

These explanations are most valuable when:

  • Getting started: Read the Gemini Protocol overview to understand what you're working with
  • Going deeper: After completing tutorials, understand the architecture to use Nauyaca effectively
  • Troubleshooting: Security model explanations help diagnose certificate or rate limiting issues
  • Contributing: Architecture knowledge is essential for making informed contributions

Complement with Other Sections

Explanations work best alongside other documentation types: