https://github.com/helgesverre/voltagent-voucher-finder
https://github.com/helgesverre/voltagent-voucher-finder
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/helgesverre/voltagent-voucher-finder
- Owner: HelgeSverre
- Created: 2025-06-06T03:31:09.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-06T03:41:54.000Z (5 months ago)
- Last Synced: 2025-07-18T10:54:21.603Z (4 months ago)
- Language: TypeScript
- Size: 63.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# VoltAgent: The accountant needs vouchers - find them for me.
Real world use-case i often find myself in that i wanted to try to automate using AI Agents.
An [VoltAgent](https://github.com/vercel/voltagent) application.
## Getting Started
### Prerequisites
- Node.js (v18 or newer)
- npm, yarn, or pnpm
### Installation
1. Clone this repository
2. Install dependencies
```bash
npm install
# or
yarn
# or
pnpm install
```
3. Set up environment variables
```bash
cp .env.example .env
```
Edit the `.env` file with your actual credentials:
- `OPENAI_API_KEY` - Your OpenAI API key (required)
- `GMAIL_USERNAME` and `GMAIL_PASSWORD` - Gmail credentials (optional, for automated login)
- `LEMONSQUEEZY_USERNAME` and `LEMONSQUEEZY_PASSWORD` - Lemon Squeezy credentials (optional)
- `GOOGLE_DRIVE_BASE_PATH` - Path to your local Google Drive folder (required for local receipt search)
### Development
Run the development server:
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
```
## Features
This project uses VoltAgent, a framework for building AI agents with the following capabilities:
- **Core** - The foundation for building and running AI agents
- **Vercel AI Provider** - Integration with Vercel AI SDK for LLM access
- **Custom Tools** - Add your own capabilities for your agents
## Project Structure
```
.
├── src/
│ └── index.ts # Main application entry point with agent definition
├── .voltagent/ # Auto-generated folder for agent memory
├── package.json
├── tsconfig.json
└── README.md
```
## License
MIT