# sujithsai-kalakonda/searchy architecture

> Architecture diagram of the GitHub repository sujithsai-kalakonda/searchy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sujithsai-kalakonda/searchy
- Repository: https://github.com/sujithsai-kalakonda/searchy

## Overview

This is a small command-line search application. Its workflow is: the entry point crawls an example URL into a page collection, builds an index, then repeatedly accepts queries, searches the index, and displays matching page metadata and scores. Search scoring delegates to indexer functions. The crawler and indexer implementations were not excerpted, so their internal behavior and external connections are not shown; no README was provided.

Main entry points: [`main.py`](https://github.com/sujithsai-kalakonda/searchy/blob/main/main.py) (CLI entry point), [`searcher.py`](https://github.com/sujithsai-kalakonda/searchy/blob/main/searcher.py) (Query search), [`indexer.py`](https://github.com/sujithsai-kalakonda/searchy/blob/main/indexer.py) (Indexer and scoring), [`crawler.py`](https://github.com/sujithsai-kalakonda/searchy/blob/main/crawler.py) (Web crawler)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_app["CLI entry point<br/>[main.py]"]
node_crawler["Web crawler<br/>[crawler.py]"]
node_indexer["Indexer and scoring<br/>[indexer.py]"]
node_searcher["Query search<br/>[searcher.py]"]

node_user -->|"enters query"| node_app
node_app -->|"crawls URL"| node_crawler
node_app -->|"builds index"| node_indexer
node_app -->|"submits query"| node_searcher
node_searcher -->|"calculates scores"| node_indexer
node_app -->|"displays results"| node_user

click node_app "https://github.com/sujithsai-kalakonda/searchy/blob/main/main.py"
click node_crawler "https://github.com/sujithsai-kalakonda/searchy/blob/main/crawler.py"
click node_indexer "https://github.com/sujithsai-kalakonda/searchy/blob/main/indexer.py"
click node_searcher "https://github.com/sujithsai-kalakonda/searchy/blob/main/searcher.py"

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_user toneBlue
class node_app,node_crawler,node_indexer,node_searcher toneTeal
```

## Components

### Other components

- **User**
- [CLI entry point](https://github.com/sujithsai-kalakonda/searchy/blob/main/main.py): `main.py`
- [Web crawler](https://github.com/sujithsai-kalakonda/searchy/blob/main/crawler.py): `crawler.py`
- [Indexer and scoring](https://github.com/sujithsai-kalakonda/searchy/blob/main/indexer.py): `indexer.py`
- [Query search](https://github.com/sujithsai-kalakonda/searchy/blob/main/searcher.py): `searcher.py`

## Connections

- User → CLI entry point: enters query (evidence: `main.py`)
- CLI entry point → Web crawler: crawls URL (evidence: `main.py`)
- CLI entry point → Indexer and scoring: builds index (evidence: `main.py`)
- CLI entry point → Query search: submits query (evidence: `main.py`)
- Query search → Indexer and scoring: calculates scores (evidence: `searcher.py`)
- CLI entry point → User: displays results (evidence: `main.py`)
