Architecture note
Available for software engineering roles - backend systems, production reliability, cloud deployment, and AI-assisted workflows.
Offline-first BackPocket OS pivot for operator-owned AI workflows, with local data ownership, approval gates, and small-business admin automation.
01
Small operators need admin leverage without handing business context fully to a cloud-only assistant.
The important workflow is not just chat; it is turning requests, documents, reminders, and follow-ups into approved operational actions.
02
A voice-first and approval-first assistant concept for quotes, email triage, lead tracking, job notes, and document search.
A local storage direction where sensitive workflow context can remain operator-owned.
A fallback AI design using local inference first where possible, then hosted providers when needed.
03
FastAPI backend direction with local persistence.
SQLite-first storage model with later PostgreSQL/self-hosted path.
Gmail/Drive/Sheets integration planning.
Human approval boundaries before emails, quotes, payments, or destructive updates.
RAG-assisted document context for business records.
04
Prototype / design pivot. It should be discussed as a product exploration, not a verified production SaaS platform.
05
Primary language: Python
Technologies: Python, FastAPI, Flutter, SQLite, Gmail, Ollama, Gemini, RAG, Docker, Dart, HTML, JavaScript, Kotlin, CSS, C++, Shell, CMake, Batchfile, PowerShell, Swift, C, VBScript, Objective C, Uvicorn, Pydantic, Docker Compose, GitHub Actions
Topics: Not specified
Last updated: 2026-05-23T18:24:20Z
Stars: 0
Forks: 0
Status: Active
Architecture note
Visual notes
Welcome to the BackPocket OS documentation hub. This folder contains comprehensive guides for all features, workflows, and system architecture.
One-time setup, takes ~2 minutes:
git clone https://github.com/Sharv619/backpocket-mvp.git
cd backpocket-mvp
npm run setup
That installs MCP dependencies, creates the shared knowledge-bank table, and wires up the git hook that auto-logs every merge into main for audit (signed with your git author + commit SHA).
Then open OpenCode in the repo. Four MCP servers load automatically from .mcp.json:
| Server | Tools | Use for |
|---|---|---|
backpocket-leads | search / get / create leads | Lead intake work |
backpocket-quotes | create quote, templates, overdue list | Quoting + follow-ups |
backpocket-pipeline | pipeline summary, record payment | Ops / reporting |
backpocket-knowledge | save / search / list notes | Shared team knowledge bank |
Rule of thumb: anything worth referencing later — marketing copy, legal notes, research findings — drop it via the save_note tool in the knowledge bank, or just merge it into main and the post-merge hook captures it for you. Every entry is signed with your git identity so audits are trivial.
Full restructure rationale: docs/MCP_RESTRUCTURE_PLAN.md.
cd /home/lade/Hackathons/.git/backpocket-mvp
python3 -m uvicorn main:app --host 127.0.0.1 --port 8000
Visit: http://127.0.0.1:8000/static/index.html
.env and find SPREADSHEET_ID.env fileBackPocket uses three specialized AI agents that learn from your feedback:
| Twin | Purpose | Best For |
|---|---|---|
| Accountant | Financial & Tax | Invoices, GST, BAS, expense tracking |
| Auditor | Compliance & QA | Document review, verification, checks |
| Admin | Operations & Workflow | Email triage, scheduling, reminders |
Each twin:
BackPocket intelligently routes API calls to minimize costs:
See AI Models & Routing for details.
python3 import_real_emails.py
Fetches your actual Gmail messages and populates the dashboard.
Via the Dashboard:
Or via API:
curl -X POST http://127.0.0.1:8000/api/drive/sync-to-rag \
-H "Content-Type: application/json" \
-d '{"folder_id":"YOUR_FOLDER_ID","twin_type":"admin"}'
curl http://127.0.0.1:8000/api/blog/generate?title=My%20Story&theme=entrepreneurship
For detailed information on any topic, see the relevant documentation file in this folder.
Need help? Check TROUBLESHOOTING.md
Next field note
Open to software engineering roles across full-stack systems, platform and reliability work, workflow automation, and applied AI.
Write to Himanshu Lade →