# Hosnian Prime — Full Documentation for AI Agents

> Infrastructure from the outer rim. Open-source Rust systems for identity, caching, and beyond.

## Organization Overview

Hosnian Prime is an open-source organization focused on building critical infrastructure software in Rust. All projects are production-grade, open-source, and designed for enterprise use.

## Project: Geonosis

**Category:** Identity & Access Management (IAM)
**Language:** Rust
**License:** MIT
**Repository:** https://github.com/hosnian-prime/geonosis
**Status:** v0.1, active development

### What it does

Geonosis is an enterprise IAM server targeting the feature surface of established platforms like Keycloak, but built from scratch in Rust for performance, safety, and modern architecture.

### Key Features

- **Protocols:** OAuth 2.1 (mandatory PKCE), OpenID Connect 1.0, SAML 2.0 (IdP & SP)
- **Authentication Flows:** Graph-DSL flow engine with 7 built-in flows (browser, direct-grant, registration, reset-credentials, first-broker-login, client-authentication, step-up)
- **Authenticators:** 11 built-in — password (Argon2id), TOTP, WebAuthn, recovery codes, magic-links, phone-OTP, consent, cookies, IdP redirects, require-action, risk-score
- **Plugin System:** WebAssembly SPI using WASI 0.2 + WIT interfaces. 9 plugin interfaces for authentication, mapping, events, policies, user storage, broker adapters, profile validators, and UI components
- **Admin UI:** Embedded Leptos server-side rendered with Tailwind CSS
- **Deployment:** Kubernetes-native with Helm charts, health probes, zero-downtime migrations
- **Storage:** PostgreSQL with row-level security, in-memory backend for development
- **Caching:** Redis, LocalCache (Moka L1 + Postgres LISTEN/NOTIFY), Noop implementations
- **Federation:** LDAP/AD integration, identity brokering (OIDC + SAML SP)
- **Advanced Protocols:** Token Exchange (RFC 8693), PAR, Device Authorization, Token Revocation, Introspection

### Architecture

- 20+ Rust crates (modular workspace)
- Example apps: Rust Axum resource server, Next.js 14 + Auth.js v5 OIDC client
- 5-minute quickstart with Docker Compose
- 22 architecture documents + 20 task-oriented recipes

### Use Cases

- Single Sign-On (SSO) for enterprise applications
- Multi-tenant identity management
- API security with OAuth 2.1 / OIDC
- Custom authentication flows via WASM plugins
- Identity federation across organizations

---

## Project: Kamino

**Category:** Distributed Caching
**Language:** Rust
**License:** MIT
**Repository:** https://github.com/hosnian-prime/kamino
**Status:** Active development

### What it does

Kamino is a distributed in-memory cache library written in Rust, designed for applications that demand microsecond-level latency and high reliability.

### Key Features

- Distributed architecture for horizontal scaling
- In-memory storage for microsecond access times
- Built entirely in Rust for memory safety and performance
- Zero-compromise design philosophy

### Use Cases

- High-performance application caching
- Session storage for distributed systems
- Real-time data access layers
- Reducing database load in high-throughput applications

---

## Technology Stack

- **Primary Language:** Rust
- **Key Technologies:** WebAssembly (WASI 0.2), OAuth 2.1, OIDC, SAML, gRPC, PostgreSQL, Redis
- **Frontend:** Leptos (Rust SSR), Tailwind CSS
- **Deployment:** Kubernetes, Docker, Helm
- **Architecture:** Cloud-native, microservices-compatible, modular crate workspace

## Contact & Links

- **GitHub Organization:** https://github.com/hosnian-prime
- **Website:** https://hosnian-prime.github.io
- **Geonosis Documentation:** https://hosnian-prime.github.io/geonosis-web