# mellofordev/palmier architecture

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

- Interactive diagram: https://gitdiagram.com/mellofordev/palmier
- Repository: https://github.com/mellofordev/palmier

## Overview

Palmier is an early-stage Python toolkit for LLM applications. Its sampled runtime configures a Google Generative AI chat request, formats the user prompt, and prints the response; no REST server or OpenAI integration is present in the shown code. The CLI exposes a `startproject` command, but the sampled implementation only prints instructions rather than creating a project. The interactive `activate.py` file identifies itself as test code, so it is excluded. The graph reflects only shown behavior and documented capabilities; unsampled integrations are not inferred.

Main entry points: [`palmier/api.py`](https://github.com/mellofordev/palmier/blob/main/palmier/api.py) (Chat configuration), [`palmier/message.py`](https://github.com/mellofordev/palmier/blob/main/palmier/message.py) (Prompt formatter), [`palmier_cli/cli.py`](https://github.com/mellofordev/palmier/blob/main/palmier_cli/cli.py) (startproject command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["LLM runtime"]
  node_configure["Chat configuration<br/>[api.py]"]
  node_parser["Prompt formatter<br/>[message.py]"]
end

subgraph group_cli["Project CLI"]
  node_startproject["startproject command<br/>[cli.py]"]
end

node_developer(("Developer"))
node_google["Google Generative AI"]
node_cli_user(("CLI user"))

node_configure -->|"formats prompt"| node_parser
node_configure -->|"configures and chats"| node_google
node_cli_user -->|"runs command"| node_startproject

click node_configure "https://github.com/mellofordev/palmier/blob/main/palmier/api.py"
click node_parser "https://github.com/mellofordev/palmier/blob/main/palmier/message.py"
click node_startproject "https://github.com/mellofordev/palmier/blob/main/palmier_cli/cli.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_configure,node_parser,node_cli_user toneBlue
class node_startproject toneAmber
class node_developer,node_google toneIndigo
```

## Components

### LLM runtime

- [Chat configuration](https://github.com/mellofordev/palmier/blob/main/palmier/api.py): `palmier/api.py`
- [Prompt formatter](https://github.com/mellofordev/palmier/blob/main/palmier/message.py): `palmier/message.py`

### Project CLI

- [startproject command](https://github.com/mellofordev/palmier/blob/main/palmier_cli/cli.py): `palmier_cli/cli.py`

### Other components

- **Developer**
- **Google Generative AI**
- **CLI user**

## Connections

- Chat configuration → Prompt formatter: formats prompt (evidence: `palmier/api.py`)
- Chat configuration → Google Generative AI: configures and chats (evidence: `palmier/api.py`)
- CLI user → startproject command: runs command (evidence: `palmier_cli/cli.py`)
