A modern astrological calculation API powered by Kerykeion. Interpretations by an LLM.
This repository also configures its own agents. See what zodiac-engine tells them →
Cursor rule Cursor
This rule documents the Pydantic data models used throughout the Zodiac Engine. Call this rule when working with data validation, schemas, or API request/response models. Use it when users need to understand the data structure, want to modify existing models, or need to create new Pydantic schemas according to best…
Cursor rule Cursor
Documents the established FastAPI best practices for the Zodiac Engine, covering dependencies, Pydantic v2, DI, async/sync, error handling, responses, and performance. Fetch this rule when implementing/refactoring FastAPI code, evaluating quality, or answering user questions about project standards.
Cursor rule Cursor
This rule documents best practices for writing FastAPI tests in the Zodiac Engine. Call this rule when reviewing or creating tests, implementing test fixtures, or working with async testing. Use it when users need guidance on test structure, mocking dependencies, handling async operations, or optimizing test…
Cursor rule Cursor
This document outlines the frontend architecture, patterns and best practices for the Zodiac Engine web interface. The frontend uses a server-rendered approach with progressive enhancement via HTMX, styled with Bootstrap and minimal custom CSS.
Cursor rule Cursor
This rule outlines the recommended FastAPI best practices for the Zodiac Engine application. Call this rule when evaluating existing code, planning improvements, or implementing new features according to modern FastAPI standards. Use it when users ask about code quality, want to follow best practices, or need guidance…
Cursor rule Cursor
This rule documents the API route structure and endpoints of the Zodiac Engine. Call this rule when working with API endpoints, understanding route hierarchies, or implementing new routes. Use it when users need information about available endpoints, want to modify existing routes, or need to understand how routes are…
Cursor rule Cursor
This rule explains the service layer implementation in the Zodiac Engine. Call this rule when working with business logic, analyzing service methods, or implementing new services. Use it when users need to understand how core functionality is abstracted, how to interact with the Kerykeion library, or how to modify…
At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: