Agent Briefing

A personal intelligence briefing hub for finance, blockchain, and decentralized storage news.

Features

• LLM-powered research - Uses MiniMax-Text-01 or GPT-4o-mini for intelligent briefings
• Topics: FED/monetary policy, financial news, blockchain developments, Storj updates
• Web UI: Clean dashboard with category system and query history
• Themes: Dark, Light, Dim, Solarized
• Persistent storage: SQLite database
• Docker ready: ARM-compatible for Raspberry Pi 5

Quick Start

Prerequisites

• Node.js 18+
• npm or pnpm

Installation

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your API key

Configuration

Edit .env file:

OPENAI_API_KEY=your-api-key
OPENAI_BASE_URL=https://api.minimax.chat/v1  # For MiniMax
OPENAI_MODEL_NAME=MiniMax-Text-01
PORT=8302
HOSTNAME=0.0.0.0

Development

# Push database schema
npm run db:push

# Start development server
npm run dev -- -H 0.0.0.0 -p 8302

Visit http://localhost:8302

Production Build

npm run build
npm start

Docker

docker-compose up -d

API Endpoints

Method	Endpoint	Description
GET	/api/query	Get all queries
POST	/api/query	Create new query
GET	/api/queries/:id	Get single query
DELETE	/api/queries/:id	Delete query

Example

curl -X POST http://localhost:8302/api/query \
  -H "Content-Type: application/json" \
  -d '{"question":"What is Bitcoin?","category":"bitcoin"}'

Testing

# Build check
npm run build

# Lint check
npm run lint

Project Structure

├── src/
│   ├── app/
│   │   ├── api/
│   │   │   ├── query/route.ts      # POST/GET queries
│   │   │   └── queries/[id]/route.ts
│   │   ├── globals.css
│   │   ├── layout.tsx
│   │   └── page.tsx
│   └── lib/
│       ├── categories.ts
│       └── db/
├── docs/
│   ├── PROJECT_PLAN.md
│   ├── GIT_WORKFLOW.md
│   └── LESSONS_LEARNED_tailwind_debug.md
├── data/                    # SQLite database (gitignored)
├── Dockerfile
├── docker-compose.yml
└── SPEC.md

Categories

• 🏛️ FED & Monetary Policy
• 📊 Financial Times & US Economy
• ₿ Bitcoin
• Ξ Ethereum
• ◎ Solana
• 🔺 Avalanche
• ⛓ ChainLink
• 🗄️ Storj
• 💬 General

Tech Stack

• Next.js 14 (App Router)
• React 18
• TypeScript
• Tailwind CSS
• SQLite + Drizzle ORM
• Docker