> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firela.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> A minimalist, self-hosted AI bot for automated billing ingestion and FIRE financial planning

FIREla consists of two independent parts that work together:

<div className="firela-arch" style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: '0' }}>
  <div className="firela-bot-card" style={{ border: '1px solid #e5e7eb', borderRadius: '12px', padding: '1.25rem 1.5rem', width: '100%', textAlign: 'center', background: '#fffaf6' }}>
    <span style={{ display: 'inline-block', background: '#FF7F3F', color: '#fff', borderRadius: '9999px', padding: '0.15rem 0.6rem', fontSize: '0.7rem', fontWeight: 'bold', letterSpacing: '0.05em', marginBottom: '0.5rem' }}>BOT</span>
    <strong style={{ display: 'block', fontSize: '1.1rem' }}>firela-bot</strong>

    <p style={{ margin: '0.5rem 0 0', color: '#555', fontSize: '0.95rem' }}>
      AI advisor for FIRE planning<br />
      Automated billing ingestion
    </p>
  </div>

  <div style={{ fontSize: '1.5rem', color: '#FF7F3F', padding: '0.25rem 0', textAlign: 'center' }}>▲<br />▼</div>

  <div className="firela-app-card" style={{ border: '1px solid #e5e7eb', borderRadius: '12px', padding: '1.25rem 1.5rem', width: '100%', textAlign: 'center', background: '#fcfcfd' }}>
    <span style={{ display: 'inline-block', background: '#6b7280', color: '#fff', borderRadius: '9999px', padding: '0.15rem 0.6rem', fontSize: '0.7rem', fontWeight: 'bold', letterSpacing: '0.05em', marginBottom: '0.5rem' }}>APP</span>
    <strong style={{ display: 'block', fontSize: '1.1rem' }}>Lifetime Ledger</strong>

    <p style={{ margin: '0.5rem 0 0', color: '#555', fontSize: '0.95rem' }}>
      Beancount<br />
      Zero tracking · Full privacy
    </p>
  </div>
</div>

## Deploy firela-bot

The fastest way to run firela-bot — deploy to Cloudflare Workers with one click:

<p align="center"><small style={{ color: '#999' }}>Free tier: 100K requests/day, 10ms CPU time — more than enough for personal use.</small></p>

<p align="center" style={{ margin: '2.25rem 0' }}>
  <a href="https://deploy.workers.cloudflare.com/?url=https://github.com/fire-la/firela-bot/tree/main/packages/ui">
    <img src="https://deploy.workers.cloudflare.com/button" alt="Deploy to Cloudflare Workers" />
  </a>
</p>

## Get the Lifetime Ledger

Track your finances with complete privacy — no one sees your data but you.

<div className="firela-store-badges">
  <div className="firela-badge-wrapper">
    <img src="https://mintcdn.com/firela/k7bZ4BeGLPh9tSDD/images/app-store-badge.svg?fit=max&auto=format&n=k7bZ4BeGLPh9tSDD&q=85&s=6f3e47da309d40a6f49642882cfffb8c" alt="Download on the App Store" width="135" height="40" data-path="images/app-store-badge.svg" />

    <span className="firela-badge-label">Coming soon</span>
  </div>

  <div className="firela-badge-wrapper">
    <img src="https://mintcdn.com/firela/k7bZ4BeGLPh9tSDD/images/google-play-badge.svg?fit=max&auto=format&n=k7bZ4BeGLPh9tSDD&q=85&s=30fd0da8e2110e3707d9fea81fc852ca" alt="Get it on Google Play" width="180" height="53" data-path="images/google-play-badge.svg" />

    <span className="firela-badge-label">Coming soon</span>
  </div>
</div>

<Info>
  You can also use any Beancount-compatible tool. Your data is just plain text — no lock-in.
</Info>

## Connect them

Once you have both running, firela-bot reads your ledger data to build your financial profile and deliver personalized FIRE insights.
