Skip to main content

Serko Northsky

Welcome to the Serko Northsky documentation — your comprehensive guide to the AI-powered travel management platform.

What is Serko Northsky?

Serko Northsky is a modern cloud-native application designed to revolutionize corporate travel management. Built with cutting-edge technologies, it provides:

  • 🤖 AI-Powered Search — Intelligent flight and accommodation recommendations
  • ⚙️ Policy Compliance — Automatic enforcement of company travel policies
  • 📊 Preference Scoring — Personalized results based on user preferences
  • 🌐 Multi-Provider Integration — Seamless integration with QPX, Booking.com, and Sabre

Technology Stack

Frontend

  • Next.js 16 with TypeScript
  • Tailwind CSS for styling
  • React 19 for UI components
  • Firebase for authentication

Backend

  • FastAPI with Python 3.13
  • AlloyDB (PostgreSQL) database
  • SQLAlchemy async ORM
  • PydanticAI for AI agent orchestration

Infrastructure

  • Terraform for Infrastructure as Code
  • GKE Autopilot for Kubernetes orchestration
  • Google Artifact Registry for container images
  • AlloyDB for managed PostgreSQL
TopicDescription
InstallationSet up your local development environment
ArchitectureUnderstand the backend architecture
Flight SearchLearn about the flight search system
AccommodationExplore accommodation integrations

Getting Started

Ready to dive in? Start with the Installation Guide to set up your local development environment.

# Clone the repository
git clone <repository-url>
cd serko-northsky

# Install dependencies
pnpm install

# Generate API client
pnpm openapi:generate-client

# Start development servers
pnpm dev

This will start the frontend on http://localhost:3000 and the backend on http://localhost:8000.