Sioyek is a cross-platform PDF viewer optimized for reading research papers and technical books. Built with Qt, OpenGL, and MuPDF, it provides a rich set of features including multi-threaded rendering, annotation management (highlights, bookmarks, portals, freehand drawings), SyncTeX integration for LaTeX forward/inverse search, fuzzy text search, and a customizable command-driven interface. The architecture follows a modular design with a central MainWidget orchestrating UI state, a Document model for PDF handling, a PdfRenderer for threaded rendering, and a DatabaseManager for persistent annotation storage. The application supports both desktop and touch-optimized interfaces, with platform-specific code for Windows, macOS, Linux, and Android. While primarily an application, Sioyek incorporates data-oriented features such as SQLite-based annotation persistence, checksum-based document identification, and integration with external research tools (Google Scholar, arXiv). The repository also includes scripts for paper downloading, text-to-speech, and embedding annotations, as well as precomputed embedding data files (embedding.npy, linear.npy) likely used for text summarization or search enhancement. The codebase demonstrates strong engineering practices with reusable components like a fuzzy matching library (fzf), a SyncTeX parser, a type-safe configuration system, and a set of QML touch UI widgets. However, it also exhibits some technical debt in the form of global state, large monolithic files (main_widget.h), and platform-specific conditionals scattered throughout.
GPT Academic is a comprehensive Gradio-based web application that provides a unified interface for interacting with 30+ large language models (both commercial APIs and locally-hosted models) with specialized tools for academic research workflows. The system's core architecture revolves around a plugin-based extensible framework where functionality is organized into 'basic functions' (simple text transformations) and 'crazy functions' (complex multi-step plugins for PDF translation, LaTeX processing, code analysis, internet search, etc.). The main entry point (main.py) initializes a Gradio Blocks interface with a modular layout, dynamic plugin loading, and a custom FastAPI server wrapper that adds authentication, file access controls, and WebSocket streaming capabilities. The codebase demonstrates sophisticated multi-threading patterns for concurrent LLM requests, with a bridge abstraction layer (request_llms/bridge_all.py) that normalizes communication across diverse model providers including OpenAI, Azure, Anthropic, Qwen, ChatGLM, Spark, and many others. The plugin system supports both simple function-based plugins and class-based plugins with configurable argument menus, state management via cookies, and hot-reloading. Notable architectural components include a vector database integration for RAG workflows, a multi-agent system built on AutoGen, real-time audio processing with Alibaba ASR, and a Docker-as-a-Service pattern for delegating media processing tasks. The repository contains extensive documentation (MkDocs-based), comprehensive test coverage for plugins, CI/CD pipelines for Docker image builds, and support for multiple deployment modes (pip, conda, Docker, HuggingFace Spaces). The codebase exhibits high craftsmanship in its LLM integration layer, with features like automatic key rotation, model-specific parameter handling, streaming response management, and sophisticated error handling with watchdog timers. The plugin template system and dynamic UI generation demonstrate good software engineering practices for extensibility.
HugoBlox Kit is a modular static site framework built on Hugo, providing a block-based page builder for academic, portfolio, documentation, and marketing websites. It uses Hugo's template system with Preact for interactive components, Tailwind CSS v4 for styling, and supports various third-party services (analytics, comments, search). The architecture is a monorepo with core modules (blox, analytics, slides, integrations) and multiple starter templates. Key entry points include the block system (blox/), layouts, shortcodes, and partials. Data flows from Markdown content and YAML configuration through Hugo's build pipeline, with client-side hydration via Preact. External dependencies include Hugo Extended, Node.js, pnpm, and various CDN-hosted libraries (Reveal.js, Mermaid, KaTeX, etc.). The framework is heavily oriented toward academic and research use cases, with features like BibTeX import, publication pages, and author profiles, but also serves general-purpose sites like SaaS landing pages and documentation.
ZotLit is a dual-plugin system (Obsidian plugin + Zotero addon) that bridges Zotero's reference management with Obsidian's note-taking environment. It enables users to create literature notes from Zotero items, insert formatted citations, import annotations, and export documents via Pandoc — all within Obsidian. The system is a monorepo with three main applications: an Obsidian plugin (apps/obsidian) that provides views (annotation sidebar, references panel, citation popover, template data explorer), services (citation indexing, live updates from Zotero, Pandoc integration, note creation/update), and a settings tab; a Zotero addon (apps/zotero) that extends Zotero's menus, database status, and freshness signaling; and a documentation site (apps/docs) built with TanStack Router and Fumadocs on Cloudflare Workers. The architecture is service-oriented on the Obsidian side, with approximately 20 services wired in a service container (build.ts) using AsyncDisposableStack for lifecycle management. Shared packages (@zotlit/db, @zotlit/templates, @zotlit/protocol, @zotlit/obsidian-i18n, @zotlit/item-lookup) provide database queries over Zotero's SQLite via Drizzle ORM, template rendering with Eta/Liquid engines, a versioned HTTP wire protocol between Zotero and Obsidian, i18n Language Pack compilation, and a search index for item lookup. The codebase is well-tested with Vitest, employs modern TypeScript patterns, and maintains a comprehensive typed contract system for template data. Key workflows include: bidirectional citation linking (pandoc-style and wikilink), live preview of citations in reading view, annotation import from PDF/EPUB/snapshots with turndown HTML-to-Markdown conversion, Pandoc export with a bundled Lua filter and pinned WASM engine, batch note creation from collection selections, and a template workbench CLI for debugging and authoring templates. The system relies on Zotero's local SQLite database as the authoritative source, with a freshness detection mechanism (WAL checkpoint polling) to trigger updates in Obsidian.
This repository is a Hugo-based starter template for building an academic CV website, part of the HugoBlox ecosystem. It provides pre-configured project structure, sample content (blog posts, publications, projects, courses, events, slides), and CI/CD workflows for deployment to GitHub Pages or Netlify. The codebase is primarily configuration (Hugo, YAML, Go modules, npm packages) and Markdown content, with minimal custom layout code (a single partial for a GitHub button). Its primary value is as a boilerplate for researchers and academics to quickly spin up a personal portfolio site. While it contains no complex application logic, it demonstrates solid engineering practices through well-structured configuration, modern build tooling (Tailwind CSS v4, Pagefind search), and reusable CI/CD patterns.