ai-bookmark

AI Bookmark Manager

AI-powered bookmark manager with a Chrome sidebar UI, semantic features, and a FastAPI backend.

Structure

• extension/ — Chrome extension (TypeScript, React, Tailwind, Vite)
• backend/ — FastAPI backend (Python), Postgres, Clerk auth stub
• doc/ — PRD, Solution Design, Tasks, and mockups

Prerequisites

• Node.js 18+
• Python 3.10+
• Postgres database

Extension (Dev)

1. Install deps:

   cd extension
   npm install
   

2. Start dev build:

   npm run dev
   

3. Build production:

   npm run build
   

4. Load in Chrome:
   • Open chrome://extensions
   • Enable Developer Mode
   • Load Unpacked → Select extension/dist

Backend (Dev)

1. Configure environment:
   • Set DATABASE_URL (e.g., postgresql+asyncpg://user:pass@localhost:5432/ai_bookmark)
   • Configure Clerk credentials later (JWT verification)
2. Install deps and run:

   cd backend
   pip install -e .
   uvicorn ai_bookmark_backend.main:app --reload --port 8080
   

Notes

• Clerk integration currently stubbed; verify JWTs and extract user_id in production.
• For Aliyun FC, package FastAPI with a serverless adapter and configure VPC access to Postgres.