Teyaotlani

Modern Spartan protocol server and client implementation using asyncio

Teyaotlani (from Nahuatl: "warrior") is a Python library for building Spartan protocol servers and clients. It provides an async-first design with a clean, intuitive API.

Features

• Async-first design - Built on asyncio for high-performance concurrent connections
• Full protocol support - Complete Spartan client and server implementation
• CLI included - Command-line tools for fetching, uploading, and serving content
• Configurable server - Rate limiting, access control, and upload handling
• Type-safe - Full type annotations for modern Python development

Installation

# Using uv (recommended)
uv add teyaotlani

# Using pip
pip install teyaotlani

Quick Start

Client

import asyncio
from teyaotlani import get

async def main():
    response = await get("spartan://example.com/")
    print(response.body)

asyncio.run(main())

Server

import asyncio
from teyaotlani import ServerConfig, run_server

async def main():
    config = ServerConfig(
        host="localhost",
        port=3000,
        document_root="./capsule",
    )
    await run_server(config)

asyncio.run(main())

CLI

# Fetch a page
teyaotlani get spartan://example.com/

# Serve files
teyaotlani serve ./capsule --port 3000

# Upload content
teyaotlani upload spartan://localhost:3000/file.txt -c "Hello!"

Documentation

Full documentation is available at teyaotlani.readthedocs.io.

• Installation
• Quick Start
• API Reference

What is Spartan?

Spartan is a simple, text-focused internet protocol similar to Gemini but without TLS complexity. It's designed for:

• Lightweight content serving
• Native file uploads
• Easy implementation
• Internal networks and learning

Learn more in the Spartan Protocol explanation.

License

MIT License - see LICENSE for details.