v1.0.0-alpha

OpenSift Release Notes
Release date: February 17, 2026
Branch: main
Latest commit: 96b1867 (added setup wizard)

Included Commits

1. 96b1867 - added setup wizard
2. 3fcb603 - bug fix in PDF ingestion
3. a0f5a24 - major updates
4. a96781d - removed legacy code and API
5. 9b7e79d - updated providers

Highlights

• Added a first-run setup wizard to configure keys/tokens and launch mode in one flow.
• Improved ingestion reliability for long web articles and scanned PDFs (OCR fallbacks).
• Reworked chat UI into a sidebar + workspace layout with session management and study tools.
• Added study library, quiz tracking, and flashcard workflows in the UI/API.
• Removed legacy app paths and consolidated runtime around ui_app.py.

New Features

• Setup workflow via python opensift.py setup in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/opensift.py.
• Interactive key/token capture and .env writing (OpenAI, Anthropic, Claude Code token).
• Launch options directly from setup: ui, terminal, or both.
• Sidebar chat history/session management in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/templates/chat.html.
• Session APIs (list/export/import/new/delete) in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/ui_app.py.
• Study library APIs (save generated output, list/get/delete) in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/ui_app.py and /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/study_store.py.
• Quiz attempt history/stat tracking in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/quiz_store.py and /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/ui_app.py.
• Flashcard creation/review/due-card workflow in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/flashcard_store.py and /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/ui_app.py.

Reliability and Quality Improvements

• More robust URL ingestion pipeline in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/app/ingest.py:
  • Retry/backoff and timeout controls
  • Boilerplate/noise stripping
  • Better main-content extraction and truncation safeguards
• Better PDF handling in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/app/ingest.py:
  • Detects likely scanned PDFs
  • OCR fallback via embedded images and pdf2image + pytesseract
• Improved chunking coherence in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/app/chunking.py:
  • Break-aware chunk boundaries
  • Overlap control tuned for long documents
• Safer vector writes in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/app/vectordb.py:
  • Uses upsert for repeated ingests
  • Supports metadata where filters for scoped retrieval
• Owner-scoped retrieval fix applied across UI/CLI/MCP:
  • /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/ui_app.py
  • /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/cli_chat.py
  • /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/mcp_server.py

Architecture and Cleanup

• Legacy API surface removed and unified under ui_app:
  • /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/app/main.py now re-exports ui_app:app.
• Removed deprecated schema/template paths:
  • /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/app/schemas.py removed
  • /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/templates/index.html removed

Dependency Updates

• Added OCR-related packages in /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend/requirements.txt:
  • pillow
  • pytesseract
  • pdf2image

Docs Updates

• Setup wizard usage added to /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/README.md.

Upgrade Notes

• Recommended startup path is now:
  • cd /Volumes/Dev/repos/GitHub/OpenSift/OpenSift/backend
  • python3 opensift.py setup
• Existing users can keep direct ui/terminal commands, but setup is the new guided path.
• OCR support requires local OCR system dependencies (for pytesseract/pdf2image) in addition to Python packages.