> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peanutsapp.com/llms.txt
> Use this file to discover all available pages before exploring further.
# The Peanuts Manifesto
> Our philosophy, architecture, and what makes Peanuts unique
# The Peanuts Manifesto
> "Peanuts is not another productivity app. It's your personal data layer — a place where everything you want to remember flows in, and intelligent insights flow out."
***
## The Problem We Solve
**Traditional apps are broken by design:**
* **Rigid silos**: One app for expenses, another for habits, another for recipes, another for inventory
* **Fragmented learning**: Each app has its own logic, UI, and learning curve
* **Disconnected data**: Your life is connected, but your apps aren't
* **You adapt to them**: Apps force you into their structure instead of adapting to yours
**The result?** Digital chaos. Dozens of apps. No unified view. No cross-domain insights. You're a data entry clerk for 15 different systems.
***
## The Peanuts Solution
**One platform that molds to YOUR life:**
* **Custom "Helpers"** for anything you want to track — no templates, no limits
* **AI that understands** ALL your data together, not in silos
* **Works wherever you are** — web, mobile, Telegram, WhatsApp, voice
* **Outputs that matter** — not just storage, but insights, reports, quotes, PDFs
***
## The Architectural Manifesto
### The Three Pillars
```
┌─────────────────────────────────────────────────────────────────┐
│ ASK PEANUTS │
│ (The Intelligent Output Layer) │
│ Quotes • PDFs • Reports • Insights • Calculations │
└────────────────────────────────┬────────────────────────────────┘
│ OUTPUT
▼
┌─────────────────────────────────────────────────────────────────┐
│ USER DATA │
│ (Your Personal Data Lake) │
│ Structured entries from all Helpers │
└────────────────────────────────┬────────────────────────────────┘
▲ INPUT
│
┌─────────────────────────────────────────────────────────────────┐
│ HELPERS │
│ (Data Collection Endpoints) │
│ Log • Checklist • Schedule • Collection • Tracker │
└─────────────────────────────────────────────────────────────────┘
▲ ▲
│ │
┌─────────┴─────────┐ ┌──────────┴──────────┐
│ CHANNELS │ │ KNOWLEDGE DOCS │
│ Web • Voice │ │ PDFs • Pricing │
│ Photo • Telegram │ │ Catalogs • Rates │
│ WhatsApp │ │ │
└───────────────────┘ └─────────────────────┘
```
### Rule 1: Helpers = INPUT
Helpers are **single-purpose data collectors**. They capture information — nothing more.
* **They capture**: text, numbers, dates, photos, locations, links
* **They do NOT**: calculate, generate, analyze, or output
* **A Helper answers**: "What do you want to remember?"
Think of Helpers as specialized notebooks. Each one is designed for a specific type of information, but they all feed into the same brain.
### Rule 2: Ask Peanuts = OUTPUT
All intelligent processing happens in **Ask Peanuts**. This is where your data becomes knowledge.
* **Ask Peanuts generates**: reports, quotes, insights, PDFs, summaries, calculations
* **It sees**: ALL your data across ALL helpers simultaneously
* **Ask Peanuts answers**: "What do you want to know or create?"
Ask Peanuts is like having a personal analyst who has read every entry you've ever made and can answer any question instantly.
### Rule 3: Knowledge Docs = CONTEXT
Knowledge Documents provide **reference information** that enriches outputs.
* **What they are**: Business documents, pricing sheets, catalogs, rate cards, policies
* **How they work**: AI uses these to add context to your queries
* **Example**: "Quote for 3 hours consulting" → Peanuts pulls from your uploaded rate card
Knowledge Docs turn Ask Peanuts from a generic assistant into YOUR personalized business tool.
***
## What Makes Peanuts Unique
### Versus Traditional Apps
| Traditional Apps | Peanuts |
| --------------------- | ------------------------------------------- |
| Pre-defined structure | You define the structure |
| One use case per app | Any use case, one platform |
| Data stays in silos | All data connected |
| Fixed reports | AI-generated insights |
| Keyboard input only | Voice, photo, links, text |
| Desktop-first | Everywhere: web, mobile, Telegram, WhatsApp |
### Versus Other AI Tools
| Other AI Tools | Peanuts |
| -------------------------------- | ------------------------------------- |
| Chat-based, no persistent memory | Your data, always remembered |
| Generic responses | Your context, specific answers |
| Separate from your workflow | IS your workflow |
| Outputs only text | Outputs PDFs, quotes, reports, images |
| Forgets between sessions | Learns your patterns over time |
### The Five Peanuts Differences
Log via text, voice, photo, link, Telegram, WhatsApp, widget, or 1-click buttons
Peanuts learns YOUR patterns, YOUR vocabulary, YOUR categories — not generic models
Ask about connections between expenses and mood, meals and energy, workouts and sleep
Not just text — generate PDFs, quotes, images, reports, abstracts, calculations
Web, mobile PWA, Telegram bot, WhatsApp, email — all synced in real-time
***
## The Input Layer: Helpers
### Helper Archetypes
Every Helper belongs to one of seven archetypes, each optimized for a different type of data:
| Archetype | Purpose | Examples |
| -------------- | ------------------------------ | -------------------------------------- |
| **LOG** | Record events over time | Expenses, workouts, symptoms, meetings |
| **CHECKLIST** | Track completion of items | Tasks, shopping lists, packing lists |
| **SCHEDULE** | Time-bound items and plans | Meal plans, appointments, routines |
| **COLLECTION** | Catalog items for reference | Recipes, books, wines, contacts |
| **PLAN** | Multi-step goals with progress | Trip planning, projects, courses |
| **TRACKER** | Habits and numerical counts | Water intake, streaks, mood ratings |
| **VISUALIZER** | Visual catalog with AI preview | Wardrobe, paint colors, room layouts |
### Input Channels
Data can flow into Peanuts from anywhere:
Traditional form entry with smart fields
"I spent €50 on dinner at Mario's"
Snap receipts, meals, documents, products
Paste URLs for recipes, articles, products
Message your bot naturally
1-click quick entries from any page
**Key Principle**: All channels feed the same data structure. The entry point doesn't matter — the data ends up organized the same way.
***
## The Output Layer: Ask Peanuts
### What Ask Peanuts Does
Ask Peanuts is your intelligent interface to everything you've ever logged:
* **Answers questions** about your data across all helpers
* **Generates quotes** and estimates using your knowledge docs
* **Creates PDF reports** formatted professionally
* **Surfaces insights** and patterns you didn't know existed
* **Performs calculations** across multiple helpers
* **Generates abstracts** and summaries on demand
### Output Types
| Output Type | Example |
| ------------ | ----------------------------------------------------------- |
| **Answer** | "You spent €450 on restaurants this month" |
| **Quote** | "Based on your rate card: €1,200 for 8 hours of consulting" |
| **PDF** | Monthly expense report with charts |
| **Report** | Weekly workout summary with trends |
| **Image** | Virtual try-on preview of outfit combinations |
| **Abstract** | "Your busiest expense days are Fridays after work trips" |
| **Insight** | "You exercise less when you sleep under 7 hours" |
### The Manifesto Rule
**Peanuts states facts, not judgments.**
* ✅ "You spent €450 on restaurants, up 20% from last month"
* ❌ "You spent too much on restaurants"
Peanuts provides information. **You decide** what to do with it.
***
## The Knowledge Layer
### What Knowledge Docs Are
Knowledge Documents are business and reference materials you upload:
* PDFs, Excel files, images with text
* Rate cards, pricing sheets, catalogs
* Policies, contracts, specifications
* Product databases, inventory lists
### How They Work
Add your business documents to the Knowledge Base
Documents are processed, chunked, and indexed using RAG (Retrieval Augmented Generation)
Ask Peanuts can now reference your documents in responses
Combine your logged data with document knowledge for intelligent outputs
### Example Use Cases
* **"Quote for a 5-page website"** → Peanuts pulls from your pricing PDF
* **"What's my margin on product X?"** → Uses your cost spreadsheet
* **"Summarize our refund policy"** → Reads from uploaded policy document
* **"How many hours did I bill at my premium rate?"** → Combines time logs with rate card
***
## The Peanuts Promise
### Simplicity Over Complexity
We believe in doing a few things exceptionally well:
* **Helpers do ONE thing**: collect data
* **Ask Peanuts does ONE thing**: provide intelligent outputs
* **Knowledge Docs do ONE thing**: provide context
No feature bloat. No hidden complexity. No learning curve that takes weeks.
### Your Data, Your Control
All data stays in your account. We never sell or share your data.
Export anytime: CSV for data, PDF for reports. Your data is never locked in.
Delete helpers and all their data instantly. No hidden retention.
See exactly what data the AI uses. No black boxes.
### AI That Serves You
* AI learns **YOUR** patterns — not generic models
* AI uses **YOUR** documents — not internet scraped data
* AI gives **YOU** the insights — not recommendations for advertisers
* **You** make the decisions — AI just provides the information
***
## Who Peanuts Is For
### Primary Users
Track expenses, time, clients, projects. Generate reports and quotes on demand.
Log inventory, leads, invoices. Ask Peanuts for business insights.
Monitor meals, symptoms, medications, workouts. Spot patterns in your wellbeing.
Habits, goals, tasks with AI insights. Understand what actually moves the needle.
Recipes, wines, books, travel plans. A personal database for life's collections.
Time tracking, quotes, client management. Professional outputs from simple inputs.
### The Common Thread
> People who track things but want **more than spreadsheets**. People who want to **ASK their data questions**, not just store it.
***
## How Peanuts Works
### The User Journey
Describe what you want to track in plain language: "I want to track my daily expenses with category, amount, and notes."
AI generates a custom Helper with appropriate fields, smart defaults, and input channels.
Add data via any channel — text, voice, photo, link, Telegram, WhatsApp.
AI auto-routes entries to the right helper and structures the data.
Add business documents for enhanced context — rate cards, catalogs, policies.
These enrich your outputs with specific information.
Chat with your data. Get insights, reports, quotes, PDFs.
Receive proactive nudges about patterns and milestones.
### The Data Flow
```
┌─────────────────────────────────────────┐
│ YOU │
└──────────────────┬──────────────────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
┌────────┐ ┌──────────┐ ┌──────────┐
│ Voice │ │ Photo │ │ Text │
│ "I │ │ [Receipt]│ │ €50 │
│ spent" │ │ │ │ dinner │
└────┬───┘ └────┬─────┘ └────┬─────┘
│ │ │
└───────────────┴───────────────┘
│
▼
┌─────────────────┐
│ AI ROUTING │
│ Which Helper? │
└────────┬────────┘
│
▼
┌─────────────────┐
│ HELPER │
│ (Expenses) │
│ Structured │
│ Entry │
└────────┬────────┘
│
▼
┌─────────────────┐
│ DATA LAKE │
│ + Embeddings │
└────────┬────────┘
│
┌─────────┴─────────┐
▼ ▼
┌──────────────┐ ┌──────────────┐
│ ASK PEANUTS │ │ PROACTIVE │
│ (Query) │ │ INSIGHTS │
└──────────────┘ └──────────────┘
```
***
## Competitive Positioning
### Our Taglines
* **Primary**: "Track anything. Ask anything."
* **Alternative**: "Your life, organized by AI."
* **Feature-focused**: "One app for everything you want to remember."
* **Action-oriented**: "Log your life. Ask your data."
### The Elevator Pitch
> "Peanuts is an AI-powered personal assistant that creates custom trackers for anything you want to log — expenses, workouts, recipes, inventory, whatever.
>
> You add entries via text, voice, photo, or messaging apps. Then you can ASK Peanuts about your data: 'How much did I spend this month?' 'What's my most common workout?' 'Generate a quote for a client.'
>
> It's like having a personal assistant who remembers everything and can answer any question about your life or business."
### The One-Liner
> **"Peanuts lets you track anything and ask your data questions."**
***
## The Future We're Building
Peanuts isn't just an app — it's a vision for how personal data should work:
1. **Your data belongs to you** — not locked in corporate silos
2. **AI should serve you** — understanding YOUR context, not generic patterns
3. **Simplicity scales** — one system for everything, not dozens of apps
4. **Input should be effortless** — voice, photo, or text, wherever you are
5. **Insights should be automatic** — AI that notices what you might miss
***
**Welcome to Peanuts.** Track anything. Ask anything. Your data, your way.