alcove-dux 0.1.1

Local-first plagiarism and text-reuse evidence toolkit

Alcove Dux

Local-first similarity evidence for teachers and academic reviewers — you decide what it means.

Alcove Dux is an open-source, local-first toolkit for K-12 teachers, instructors, academic reviewers, and small institutions that need transparent similarity review without sending student documents to a closed service.

Alcove Dux is a review aid, not a verdict machine. It helps teachers and reviewers inspect similarity evidence on their own hardware, and unlike Turnitin and similar cloud services, Alcove Dux never uploads student documents to a third-party server. Similarity evidence stays on your device and is reviewed by you, not scored by an algorithm and stored by a vendor.

⚡ Start Here

• Live Demo: try a browser-only sample scan.
• Quick Start: install locally and run a sample scan.
• Institutional Deployment: run Alcove Dux on a shared departmental or school server.
• Demo Walkthrough: run the sample demo and inspect the generated report.
• CLI Usage: command reference for pairwise scans, corpus scans, semantic matching, and calibration.
• Reports: JSON, public HTML, local review HTML, and report privacy behavior.
• Privacy Boundary: what Alcove Dux does and does not expose.

🔎 What It Does

An instructor uploads two documents, runs a scan, and gets a side-by-side highlighted report — locally, without sending text to any server.

No command line is required for the main workflow: open the local dashboard in your browser, upload documents, and review the results there.

🖥️ Dashboard preview

The local dashboard is the main review surface for most teachers and academic reviewers:

• Local FastAPI dashboard for document upload, scan creation, and side-by-side review.
• Text, Markdown, PDF, and DOCX ingestion.
• Exact, fuzzy, semantic, and reranked similarity evidence.
• Pairwise scans and local-corpus scans from the CLI.
• Screen-reader-friendly dashboard and HTML reports with privacy-preserving exports.

👩‍🏫 Who This Is For

• Classroom teachers reviewing student submissions.
• Instructors comparing assignments against known sources.
• Department or institution-level academic integrity reviewers.
• Small schools and colleges that want local control instead of cloud document retention.

🏫 Institutional deployment quick path

For a shared departmental or school installation, the fastest path is usually Docker Compose on an inward-facing server:

docker compose up --build

Then open http://localhost:8000 on that machine, or place it behind your institution's normal internal access controls. See Deployment Notes for role separation, retention, and hosted-mode guidance.

📚 Documentation

• Research Notes and Benchmarks
• AI-use stigma note: why self-reported AI use is biased in education and what that changes for Alcove Dux.
• Configuration, Datasets, and Multilingual Detection
• Vector Stores and Alcove Plugin Plan
• Deployment Notes, Hosted Hardening, and Repository Setup
• Roadmap and Demo Video Script

📦 Package

The package name is alcove-dux, the import path is alcove_dux, and the CLI command is alcove-dux. The core engine can be used as a CLI, Python library, local FastAPI app, or Alcove plugin.

🤝 Contributing

Alcove Dux is maintained as a public open-source project. Contributions are encouraged to keep the local-first privacy boundary intact, include tests for behavioral changes, and keep private corpora, generated reports, model caches, and vector indexes out of public commits.

See CONTRIBUTING.md for setup, checks, and privacy rules.