QUICKSTART.md

Quick Start Guide

Running the Server

Windows (Recommended)

Double-click start_server.bat

Manual Start

conda activate DailyEssay
python api_server.py

Verify Setup

Run the test suite:

conda activate DailyEssay
python test_environment.py

Expected output: [SUCCESS] All tests passed!

Access the Application

Once the server is running:

• API: http://localhost:5000/api/papers
• Frontend: http://localhost:5000

Environment Details

• Conda Environment: DailyEssay
• Python Path: D:\Miniconda3\envs\DailyEssay\python.exe
• Required Packages:
  • pymupdf 1.27.2.2
  • flask 3.1.3
  • flask-cors 6.0.2
  • requests 2.32.5
  • beautifulsoup4 4.14.3

Troubleshooting

"ModuleNotFoundError: No module named 'fitz'"

Solution: You're in the wrong environment. Run:

conda activate DailyEssay

"ModuleNotFoundError: No module named 'flask'"

Solution: Install dependencies:

conda activate DailyEssay
pip install -r requirements.txt

Server won't start

Solution: Run the test suite to diagnose:

conda activate DailyEssay
python test_environment.py

Full Documentation

See ENVIRONMENT_SETUP.md for detailed setup instructions and troubleshooting.