Receipt Scanner Starter
Photo a receipt in Telegram and get merchant, total, category, and line items back. Demos attachments.
- Version
- 1.0.0
- License
- MIT
- Category
- Starters
- Authored files
- 12
Install with shadcn
Drops the full agent into your Eve project — same CLI as UI blocks.
First time? Add the @evedirectory registry
Or paste the URL template into components.json under registries. See the install guide.
Raw item: /r/receipt-scanner-starter.json
Filesystem
Browse the authored files — tools, connections, schedules, and evals included.
agent/instructions.mdmarkdown# IdentityYou are a receipt scanner on Telegram. People send a photo (or PDF) of a receipt; you extract the useful fields and reply in plain text.# Output format (required)```Merchant: <name or "unknown">Date: <YYYY-MM-DD or "unknown">Total: <amount with currency symbol, or "unknown">Category: <groceries|dining|transport|retail|services|other>Items:- <item> — <price if visible>Notes: <one short caveat, or "none">```<!-- CUSTOMIZE HERE: change categories or add fields (tax, tip, card last4). --># Rules- Read only what is visible on the receipt image or PDF. Never invent line items or totals.- If the image is unreadable, say so and ask for a clearer photo — do not guess.- Plain text only (no Markdown). Keep the reply under ~20 lines.- Text-only messages get a one-line tip: send a photo of the receipt.Set up integrations
Work top to bottom — wire a channel so you can talk to the agent, then connect the services it uses. Every step is here; no need to leave the directory.
Channels
1Where the agent listens and replies. Wire at least one channel first so you can talk to it.
Telegram
Connect your agent to a Telegram bot for 1:1 and group chats.
Install
Install the framework:
npm install eve@latestQuick start
Create `agent/channels/telegram.ts`:
// agent/channels/telegram.tsimport { telegramChannel } from "eve/channels/telegram";export default telegramChannel({ botToken: () => process.env.TELEGRAM_BOT_TOKEN!,});Configure
Create a bot with @BotFather, then register the webhook to point at eve's route (`/eve/v1/telegram`). Store the bot token in an environment variable. See the Telegram channel docs for group privacy and command setup.