Stellar AI Guide

A country-agnostic monorepo of developer guides for building on Stellar with AI tooling. Country-specific content lives in countries/<code>/; everything that applies across regions sits at the repo root.

The structure follows the same pattern as ElliotFriend/regional-starter-pack: a single repo with regional folders, so a builder in any supported country can clone once and find the right guide for their rails.

Layout

.
├── README.md                       # You are here
├── CONTRIBUTING.md                 # How to add a new country
├── Claude_Code_Guide.md            # Claude Code commands, parallel agents, browser automation
├── Free_AI_Setup.md                # Free AI tooling (FreeLLMAPI, Freebuff, OpenRouter, Groq, Ollama, ...)
├── Recommended_AI_Tools.md         # Curated map of the Stellar / AI tool ecosystem
├── Starter_Prompts.md              # Protocol context block, CLAUDE.md template, corrective prompts
└── countries/
    ├── _template/                  # Skeleton for adding a new country
    ├── mx/                         # Mexico: SPEI, CETES, AlfredPay, BlindPay, Etherfuse
    │   ├── README.md
    │   ├── Dev_Setup_Guide.md
    │   └── Hackathon_Resources.md
    └── br/                         # Brazil: PIX, TESOURO, BRZ, Etherfuse, Transfero
        ├── README.md
        ├── Dev_Setup_Guide.md
        ├── Hackathon_Resources.md
        └── PIX_Guide.md

The four country-agnostic docs at the root (Claude_Code_Guide.md, Free_AI_Setup.md, Recommended_AI_Tools.md, Starter_Prompts.md) cover everything that doesn't change country to country — AI tooling, Claude Code workflow, paste-ready prompts. Country folders only hold the bits that genuinely differ: which anchors apply, which assets exist, which currency the rail uses.

Supported countries

Code	Country	Rails covered	Primary anchor path
mx	Mexico	SPEI	Etherfuse (MXN ↔ CETES), AlfredPay (MXN ↔ USDC), BlindPay (MXN ↔ USDB)
br	Brazil	PIX	Etherfuse (BRL ↔ TESOURO); Transfero (BRZ), Abroad Finance, Alfred Pay as ecosystem refs

How to use this repo

1. Read the country-agnostic docs first if you've never used Claude Code on a Stellar project:
   • Starter_Prompts.md — paste-ready protocol context, the wallet-vs-dApp distinction, CLAUDE.md template
   • Free_AI_Setup.md — free AI tooling: FreeLLMAPI (16 providers in one endpoint), Freebuff, OpenRouter, Groq, and the rest of the free stack
   • Claude_Code_Guide.md — commands, parallel agents, browser automation
   • Recommended_AI_Tools.md — what AI tools exist in and around the Stellar ecosystem
2. Open the country folder that matches your rails. Each country folder has its own README.md that walks through the local setup, the anchors with self-service developer flows, and the gotchas that have cost builders hours in past hackathons.
3. If your project touches more than one country, read both folders. The root docs apply unchanged.

Adding a new country

See CONTRIBUTING.md and copy countries/_template/ as a starting point.

Lineage

This repo merges and supersedes two earlier single-country repos:

• kaankacar/stellar-ai-guide-mx — Mexico (Hack+ Alebrije | CDMX 2026)
• kaankacar/stellar-ai-guide-br — Brazil

Both originals will keep working, but new edits land here.