Skip to content

Tutorials

Welcome to the Nauyaca tutorials! This section contains hands-on, step-by-step guides designed to help you learn by doing. Each tutorial walks you through a complete task from start to finish, building your understanding of the Gemini protocol and the Nauyaca implementation.

Available Tutorials

  • Your First Capsule

    Build and serve your first Gemini capsule in minutes. Learn the basics of server setup, content creation, and navigation.

    Level: Beginner Time: ~15 minutes

    Start tutorial

  • Building a Client

    Write a Python application that fetches and displays Gemini content. Understand the client protocol and TOFU security.

    Level: Intermediate Time: ~20 minutes

    Start tutorial

  • Securing Your Server

    Add rate limiting, access control, and certificate authentication to protect your capsule from abuse.

    Level: Intermediate Time: ~30 minutes

    Start tutorial

Prerequisites

Before starting these tutorials, you should have:

  • Python 3.11 or later installed on your system
  • Nauyaca installed - See the Installation Guide if you haven't already
  • Basic Python knowledge - Understanding of functions, async/await, and basic command-line usage
  • Text editor - Any editor you're comfortable with

If you're new to Nauyaca or the Gemini protocol, we recommend following the tutorials in this order:

  1. Start with Your First Capsule to understand the server side and Gemini content format
  2. Move to Building a Client to see how clients interact with capsules
  3. Finish with Securing Your Server to learn production-ready security practices

Each tutorial is self-contained, so you can also jump directly to the one that interests you most.

Getting Help

If you get stuck or have questions while working through a tutorial:

Ready to start? Choose your first tutorial above and begin your journey with Nauyaca!