================================================================================
                         SOCRATES AI - WINDOWS EDITION
                            Version 1.3.0
================================================================================

Thank you for downloading Socrates AI!

This package contains everything you need to run Socrates AI on Windows.

================================================================================
QUICK START (Choose One)
================================================================================

OPTION 1: INSTANT START (No Installation)
────────────────────────────────────────
Just double-click: socrates.exe

The application will launch in FULL STACK mode:
  • API Server (FastAPI) - auto-runs on available port
  • React Frontend - opens in your browser automatically
  • Complete Socrates AI experience ready to use

This is the easiest way to get started!


OPTION 2: INSTALLER (Creates Shortcuts)
────────────────────────────────────────
1. Right-click: install_socrates.bat
2. Select: "Run as administrator"
3. Follow the prompts
4. Desktop and Start Menu shortcuts will be created

Desktop shortcut launches FULL STACK mode with:
  • API + Frontend
  • Browser auto-open
  • Perfect for regular users

This option installs Socrates to your Program Files directory.


================================================================================
WHAT'S IN THIS PACKAGE?
================================================================================

socrates.exe              - Main application (ready to run)
install_socrates.bat     - Installer script (optional)
INSTALL_WINDOWS.md       - Detailed installation guide
README_WINDOWS_PACKAGE.txt - This file


================================================================================
SYSTEM REQUIREMENTS
================================================================================

✓ Windows 7, 8, 10, or 11 (64-bit)
✓ 2 GB RAM minimum
✓ 1 GB free disk space
✓ Internet connection (for AI features)


================================================================================
FIRST-TIME SETUP
================================================================================

1. Run socrates.exe (double-click or use installer)
2. The application will initialize on first launch (5-10 seconds)
3. A CONSOLE WINDOW will appear (see below)
4. A BROWSER WINDOW will open with the Socrates interface
5. Configure your API key if you want to use AI features
6. Start using Socrates!


================================================================================
CONSOLE WINDOW (IMPORTANT!)
================================================================================

A console (terminal) window will appear when you launch Socrates.

✓ THIS IS NORMAL - Do not close it!
✓ Shows API server status and activity
✓ Displays startup messages like:
    [INFO] API server starting on http://localhost:8000
    [INFO] Frontend starting on http://localhost:5173
    [INFO] Press Ctrl+C to shutdown

KEEPING IT OPEN:
  • Browser window opens in front of it
  • Keep both windows open while using Socrates
  • You can minimize the console if you prefer

STOPPING SOCRATES:
  1. Click in the console window
  2. Press Ctrl+C
  3. Wait for graceful shutdown (5-10 seconds)
  4. Both console and browser will close

WARNING - DO NOT:
  ✗ Close console window without Ctrl+C (risk of data loss)
  ✗ Force close via Task Manager (risk of data loss)
  ✗ Close browser only (server keeps running in background)


================================================================================
GETTING HELP
================================================================================

If you encounter any issues:

1. Check INSTALL_WINDOWS.md for detailed troubleshooting
2. Review the full documentation at:
   https://github.com/Nireus79/Socrates/tree/master/docs
3. Report issues at:
   https://github.com/Nireus79/Socrates/issues


================================================================================
FEATURES
================================================================================

✓ Socratic AI Guidance      - Learn through interactive questioning
✓ Multi-Agent System        - Specialized agents for different tasks
✓ Knowledge Management      - RAG-powered knowledge base
✓ Real-Time Collaboration   - Work together in real-time
✓ GitHub Integration        - Export projects to GitHub
✓ Production-Ready          - Enterprise security features


================================================================================
LICENSE & ATTRIBUTION
================================================================================

Socrates AI is released under the MIT License.

This software includes several open-source projects:
• Python runtime and standard library
• FastAPI framework
• PyTorch and related ML libraries
• And many others (see full attribution in docs)

All dependencies are included with their original licenses.


================================================================================
PRIVACY & SECURITY
================================================================================

✓ Data stored locally on your computer
✓ API calls transmitted securely to Anthropic
✓ No personal data collection without consent
✓ Open source - code is publicly available on GitHub


================================================================================
SUPPORT & RESOURCES
================================================================================

Website:           https://github.com/Nireus79/Socrates
Documentation:     https://github.com/Nireus79/Socrates/tree/master/docs
Bug Reports:       https://github.com/Nireus79/Socrates/issues
PyPI Package:      https://pypi.org/project/socrates-ai/


================================================================================
TIPS & TRICKS
================================================================================

• First launch takes 2-5 seconds (normal - initializing Python runtime)
• Run as Administrator if you encounter permissions issues
• Close other apps if experiencing performance issues
• Check logs in: %APPDATA%\Local\Socrates\
• Use --verbose flag for debugging: socrates.exe --verbose


================================================================================
UNINSTALLING
================================================================================

Method 1 (If installed via installer):
  Settings → Apps → Apps & Features → Find "Socrates AI" → Uninstall

Method 2 (Standalone):
  Simply delete socrates.exe and the desktop shortcut

Note: Configuration files remain in %APPDATA%\Local\Socrates\ if you want
to preserve them, or delete this folder for a complete removal.


================================================================================
VERSION INFORMATION
================================================================================

Version:           1.3.0
Release Date:      2026-01-18
Platform:          Windows 64-bit
Architecture:      x86-64
Python Runtime:    3.11 (embedded)
File Size:         ~500-800 MB (varies with features)


================================================================================
GETTING STARTED
================================================================================

1. Extract this package to a location of your choice
2. Run socrates.exe or install_socrates.bat
3. Follow the on-screen setup wizard
4. Start using Socrates!

For detailed instructions, see INSTALL_WINDOWS.md


================================================================================
QUESTIONS?
================================================================================

Check the documentation first - most common questions are answered there!

If you still need help, open an issue on GitHub with:
• Your Windows version (winver in Command Prompt)
• The error message or problem description
• Steps to reproduce the issue


================================================================================

Thank you for using Socrates AI!

We hope you find it valuable for your development and learning goals.

For feedback and feature requests, visit:
https://github.com/Nireus79/Socrates/discussions

================================================================================
