Merge pull request #173 from mongodb-developer/interactive_journal

Adds code for an interactive journalizing app

Author: ajosh0504

apps/interactive-journal/.gitignore

@@ -0,0 +1,42 @@
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+.venv/
+env/
+.eggs/
+*.egg-info/
+.pytest_cache/
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build outputs
+dist/
+build/
+*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/

apps/interactive-journal/README.md

@@ -0,0 +1,40 @@
+## Setup
+
+### Backend
+
+```bash
+cd backend
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Create .env file
+cp .env.example .env
+# Edit .env with your values:
+# MONGODB_URI=your-mongodb-connection-string
+# ANTHROPIC_API_KEY=your-anthropic-api-key
+# VOYAGE_API_KEY=your-voyage-api-key
+
+# Run the server
+uvicorn app.main:app --reload
+```
+
+Backend runs at http://localhost:8000
+
+### Frontend
+
+```bash
+cd frontend
+
+# Install dependencies
+npm install
+
+# Run the dev server
+npm run dev
+```
+
+Frontend runs at http://localhost:5173

apps/interactive-journal/backend/.env.example

@@ -0,0 +1,14 @@
+# MongoDB Atlas connection string
+MONGODB_URI=your-mongodb-connection-string-here
+
+# Database name
+DATABASE_NAME=memoir
+
+# Anthropic API key
+ANTHROPIC_API_KEY=your-anthropic-api-key-here
+
+# Anthropic model to use
+ANTHROPIC_MODEL=claude-sonnet-4-5
+
+# Voyage AI API key (for V2 semantic search)
+VOYAGE_API_KEY=your-voyage-api-key-here

apps/interactive-journal/backend/app/__init__.py

@@ -0,0 +1 @@
+# Memoir - Interactive Journaling App

apps/interactive-journal/backend/app/config.py

@@ -0,0 +1,25 @@
+import os
+
+# User config
+USER_ID = "Apoorva"
+
+# MongoDB config
+MONGODB_URI = os.getenv("MONGODB_URI", "mongodb://localhost:27017")
+DATABASE_NAME = os.getenv("DATABASE_NAME", "memoir")
+
+# Anthropic config
+ANTHROPIC_API_KEY = os.getenv("ANTHROPIC_API_KEY")
+ANTHROPIC_MODEL = os.getenv("ANTHROPIC_MODEL", "claude-sonnet-4-5")
+
+# Voyage AI config
+VOYAGE_API_KEY = os.getenv("VOYAGE_API_KEY")
+VOYAGE_MULTIMODAL_MODEL = "voyage-multimodal-3.5"
+VOYAGE_TEXT_MODEL = "voyage-3-large"
+
+# Vector search config
+VECTOR_INDEX_NAME = "vector_index"
+VECTOR_DIMENSIONS = 1024
+VECTOR_NUM_CANDIDATES = 100
+
+# Image config
+IMAGE_SIZE = (1024, 1024)

apps/interactive-journal/backend/app/main.py

@@ -0,0 +1,59 @@
+from dotenv import load_dotenv
+
+load_dotenv(override=True)
+
+import logging
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from app.routers import routes
+from app.services.mongodb import close_db, connect_db
+
+logging.basicConfig(
+    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+)
+logger = logging.getLogger(__name__)
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Startup
+    logger.info("Starting Memoir API...")
+    connect_db()
+    logger.info("Memoir API started successfully")
+    yield
+    # Shutdown
+    logger.info("Shutting down Memoir API...")
+    close_db()
+
+
+app = FastAPI(
+    title="Memoir",
+    description="AI-powered interactive journaling application",
+    version="1.0.0",
+    lifespan=lifespan,
+)
+
+# CORS middleware for frontend
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["http://localhost:5173"],  # Vite default port
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Include routers
+app.include_router(routes.router, prefix="/api/entries", tags=["entries"])
+
+
+@app.get("/")
+def root():
+    return {"message": "Welcome to Memoir API"}
+
+
+@app.get("/health")
+def health_check():
+    return {"status": "healthy"}

apps/interactive-journal/backend/app/routers/__init__.py

@@ -0,0 +1 @@
+# Routers module