# astroinsightapi/astroinsight-ruby-sdk architecture

> Architecture diagram of the GitHub repository astroinsightapi/astroinsight-ruby-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/astroinsightapi/astroinsight-ruby-sdk
- Repository: https://github.com/astroinsightapi/astroinsight-ruby-sdk

## Overview

AstroInsight is a Ruby SDK that turns client configuration and astrology inputs into authenticated Astro Insight API requests, then returns parsed responses or raises typed errors. Users create a client, select a service, and provide birth or match data where needed. The graph preserves the README’s major service families while grouping unsampled service implementations by their existing directories. Connections from sampled service methods to HTTP transport are shown where excerpts demonstrate them; directory-level service behavior is based on the README and container wiring.

Main entry points: [`lib/astroinsight/http_client.rb`](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/http_client.rb) (HTTP client), [`lib/astroinsight/client.rb`](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/client.rb) (Client facade), [`lib/astroinsight/services/vedic_container.rb`](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic_container.rb) (Vedic access), [`lib/astroinsight/services/vedic/astro_details.rb`](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/astro_details.rb) (Birth astrology)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Client setup"]
  node_client["Client facade<br/>[client.rb]"]
  node_config["Configuration<br/>[configuration.rb]"]
end

subgraph group_vedic["Vedic services"]
  node_vedic_container["Vedic access<br/>[vedic_container.rb]"]
  node_vedic_astrology["Birth astrology<br/>[astro_details.rb]"]
  node_vedic_dasha["Dashas"]
  node_vedic_lal["Lal Kitab<br/>[lal_kitab.rb]"]
  node_vedic_muhurta["Muhurta<br/>[muhurta.rb]"]
  node_vedic_varsha["Varshaphal<br/>[varshaphal.rb]"]
  node_vedic_match["Matchmaking<br/>[match_making.rb]"]
  node_vedic_calendar["Panchang<br/>[panchang.rb]"]
  node_vedic_other["Other Vedic tools"]
end

subgraph group_western["Western services"]
  node_western_container["Western access"]
  node_western_transit["Transits<br/>[transit.rb]"]
  node_western_other["Western astrology"]
end

subgraph group_other["Other services"]
  node_horoscope["Horoscope<br/>[horoscope.rb]"]
  node_tarot["Tarot readings<br/>[tarot.rb]"]
  node_chinese["Chinese astrology"]
  node_geo["Geolocation<br/>[geo.rb]"]
end

subgraph group_transport["Transport and data"]
  node_birth["Birth details<br/>[birth_details.rb]"]
  node_match_input["Match input<br/>[match_input.rb]"]
  node_http["HTTP client<br/>[http_client.rb]"]
  node_errors["SDK errors<br/>[error.rb]"]
end

node_user(("SDK user"))
node_api{{"Astro Insight API"}}

node_user -->|"creates"| node_client
node_client -->|"configures"| node_config
node_client -->|"creates"| node_vedic_container
node_client -->|"creates"| node_western_container
node_client -->|"creates"| node_horoscope
node_client -->|"creates"| node_tarot
node_client -->|"creates"| node_chinese
node_client -->|"creates"| node_geo
node_client -->|"creates"| node_http
node_vedic_container -->|"initializes"| node_vedic_astrology
node_vedic_container -->|"initializes"| node_vedic_dasha
node_vedic_container -->|"initializes"| node_vedic_lal
node_vedic_container -->|"initializes"| node_vedic_muhurta
node_vedic_container -->|"initializes"| node_vedic_varsha
node_vedic_container -->|"initializes"| node_vedic_match
node_vedic_container -->|"initializes"| node_vedic_calendar
node_western_container -->|"initializes"| node_western_transit
node_user -->|"provides"| node_birth
node_user -->|"provides"| node_match_input
node_match_input -->|"normalizes"| node_birth
node_vedic_astrology -->|"posts data"| node_http
node_vedic_dasha -->|"posts data"| node_http
node_vedic_match -.->|"sends request"| node_http
node_vedic_muhurta -.->|"sends request"| node_http
node_vedic_lal -.->|"sends request"| node_http
node_vedic_varsha -.->|"sends request"| node_http
node_vedic_calendar -.->|"sends request"| node_http
node_western_transit -->|"posts data"| node_http
node_western_other -.->|"sends request"| node_http
node_horoscope -.->|"sends request"| node_http
node_tarot -->|"posts reading"| node_http
node_chinese -.->|"sends request"| node_http
node_geo -.->|"sends request"| node_http
node_http -->|"reads settings"| node_config
node_http -->|"sends request"| node_api
node_api -->|"returns response"| node_http
node_http -->|"raises typed errors"| node_errors

click node_client "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/client.rb"
click node_config "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/configuration.rb"
click node_vedic_container "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic_container.rb"
click node_vedic_astrology "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/astro_details.rb"
click node_vedic_dasha "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/vimshottari_dasha.rb"
click node_vedic_lal "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/lal_kitab.rb"
click node_vedic_muhurta "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/muhurta.rb"
click node_vedic_varsha "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/varshaphal.rb"
click node_vedic_match "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/match_making.rb"
click node_vedic_calendar "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/panchang.rb"
click node_vedic_other "https://github.com/astroinsightapi/astroinsight-ruby-sdk/tree/main/lib/astroinsight/services/vedic"
click node_western_container "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/western_container.rb"
click node_western_transit "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/western/transit.rb"
click node_western_other "https://github.com/astroinsightapi/astroinsight-ruby-sdk/tree/main/lib/astroinsight/services/western"
click node_horoscope "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/horoscope.rb"
click node_tarot "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/tarot.rb"
click node_chinese "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/chinese_astrology.rb"
click node_geo "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/geo.rb"
click node_birth "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/models/birth_details.rb"
click node_match_input "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/models/match_input.rb"
click node_http "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/http_client.rb"
click node_errors "https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/error.rb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client,node_config,node_user toneBlue
class node_vedic_container,node_vedic_astrology,node_vedic_dasha,node_vedic_lal,node_vedic_muhurta,node_vedic_varsha,node_vedic_match,node_vedic_calendar,node_vedic_other toneAmber
class node_western_container,node_western_transit,node_western_other,node_api toneMint
class node_horoscope,node_tarot,node_chinese,node_geo toneRose
class node_birth,node_match_input,node_http,node_errors toneIndigo
```

## Components

### Client setup

- [Client facade](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/client.rb): `lib/astroinsight/client.rb`
- [Configuration](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/configuration.rb): `lib/astroinsight/configuration.rb`

### Vedic services

- [Vedic access](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic_container.rb): `lib/astroinsight/services/vedic_container.rb`
- [Birth astrology](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/astro_details.rb): `lib/astroinsight/services/vedic/astro_details.rb`
- [Dashas](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/vimshottari_dasha.rb): `lib/astroinsight/services/vedic/vimshottari_dasha.rb`
- [Lal Kitab](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/lal_kitab.rb): `lib/astroinsight/services/vedic/lal_kitab.rb`
- [Muhurta](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/muhurta.rb): `lib/astroinsight/services/vedic/muhurta.rb`
- [Varshaphal](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/varshaphal.rb): `lib/astroinsight/services/vedic/varshaphal.rb`
- [Matchmaking](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/match_making.rb): `lib/astroinsight/services/vedic/match_making.rb`
- [Panchang](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/vedic/panchang.rb): `lib/astroinsight/services/vedic/panchang.rb`
- [Other Vedic tools](https://github.com/astroinsightapi/astroinsight-ruby-sdk/tree/main/lib/astroinsight/services/vedic): `lib/astroinsight/services/vedic`

### Western services

- [Western access](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/western_container.rb): `lib/astroinsight/services/western_container.rb`
- [Transits](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/western/transit.rb): `lib/astroinsight/services/western/transit.rb`
- [Western astrology](https://github.com/astroinsightapi/astroinsight-ruby-sdk/tree/main/lib/astroinsight/services/western): `lib/astroinsight/services/western`

### Other services

- [Horoscope](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/horoscope.rb): `lib/astroinsight/services/horoscope.rb`
- [Tarot readings](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/tarot.rb): `lib/astroinsight/services/tarot.rb`
- [Chinese astrology](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/chinese_astrology.rb): `lib/astroinsight/services/chinese_astrology.rb`
- [Geolocation](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/services/geo.rb): `lib/astroinsight/services/geo.rb`

### Transport and data

- [Birth details](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/models/birth_details.rb): `lib/astroinsight/models/birth_details.rb`
- [Match input](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/models/match_input.rb): `lib/astroinsight/models/match_input.rb`
- [HTTP client](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/http_client.rb): `lib/astroinsight/http_client.rb`
- [SDK errors](https://github.com/astroinsightapi/astroinsight-ruby-sdk/blob/main/lib/astroinsight/error.rb): `lib/astroinsight/error.rb`

### Other components

- **SDK user**
- **Astro Insight API**

## Connections

- SDK user → Client facade: creates
- Client facade → Configuration: configures (evidence: `lib/astroinsight/client.rb`)
- Client facade → Vedic access: creates (evidence: `lib/astroinsight/client.rb`)
- Client facade → Western access: creates (evidence: `lib/astroinsight/client.rb`)
- Client facade → Horoscope: creates (evidence: `lib/astroinsight/client.rb`)
- Client facade → Tarot readings: creates (evidence: `lib/astroinsight/client.rb`)
- Client facade → Chinese astrology: creates (evidence: `lib/astroinsight/client.rb`)
- Client facade → Geolocation: creates (evidence: `lib/astroinsight/client.rb`)
- Client facade → HTTP client: creates (evidence: `lib/astroinsight/client.rb`)
- Vedic access → Birth astrology: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Vedic access → Dashas: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Vedic access → Lal Kitab: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Vedic access → Muhurta: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Vedic access → Varshaphal: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Vedic access → Matchmaking: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Vedic access → Panchang: initializes (evidence: `lib/astroinsight/services/vedic_container.rb`)
- Western access → Transits: initializes (evidence: `lib/astroinsight/services/western_container.rb`)
- SDK user → Birth details: provides
- SDK user → Match input: provides
- Match input → Birth details: normalizes (evidence: `lib/astroinsight/models/match_input.rb`)
- Birth astrology → HTTP client: posts data (evidence: `lib/astroinsight/services/vedic/astro_details.rb`)
- Dashas → HTTP client: posts data (evidence: `lib/astroinsight/services/vedic/vimshottari_dasha.rb`)
- Matchmaking → HTTP client: sends request
- Muhurta → HTTP client: sends request
- Lal Kitab → HTTP client: sends request
- Varshaphal → HTTP client: sends request
- Panchang → HTTP client: sends request
- Transits → HTTP client: posts data (evidence: `lib/astroinsight/services/western/transit.rb`)
- Western astrology → HTTP client: sends request
- Horoscope → HTTP client: sends request
- Tarot readings → HTTP client: posts reading (evidence: `lib/astroinsight/services/tarot.rb`)
- Chinese astrology → HTTP client: sends request
- Geolocation → HTTP client: sends request
- HTTP client → Configuration: reads settings (evidence: `lib/astroinsight/http_client.rb`)
- HTTP client → Astro Insight API: sends request (evidence: `lib/astroinsight/http_client.rb`)
- Astro Insight API → HTTP client: returns response (evidence: `lib/astroinsight/http_client.rb`)
- HTTP client → SDK errors: raises typed errors (evidence: `lib/astroinsight/http_client.rb`)
