# Repository: HugoBlox/kit # Stars: 9407 ## CLAUDE.md AGENTS.md ## README.md [**中文**](./README.zh.md)

HugoBlox: Your Open Publishing Stack

Publish notebooks, docs, portfolios, and knowledge bases from Markdown + Jupyter.
Built for data scientists, AI engineers, researchers, labs, and tech startups who want speed without lock-in: Hugo + Tailwind with optional Researcher Plan automation (visual editing, imports, fixes, and upgrades).

Start Free in Browser • Get Ownable CMS (VS Code)

_{Researchers & Labs
•
Data Scientists & AI Engineers
•
Teams & Orgs
•
Automations & Plans}

_{Trusted since 2016 · 150,000+ researchers and scientists (Meta, Stanford, NVIDIA) · Rated 4.9/5 by users (official survey) · Used by teams like NVIDIA Research Labs, King’s College London, and MIT · Featured by GitHub Release Radar}

https://github.com/user-attachments/assets/a0be0c48-b8d5-4b40-a11b-85fedcdf89bc --- ## ⚡️ Why teams choose HugoBlox In the age of AI, **Markdown is the new source code**. HugoBlox gives you the speed of modern tooling with the durability of a static stack: **Hugo + Tailwind** (with optional Alpine/Svelte blocks for interactivity). - **Own your content**: clean Markdown, YAML, and notebooks — portable, readable, and LLM-friendly. - **Performance without the ops tax**: static output, fast builds, no runtime database. - **Beautiful by default**: high-quality templates + blocks (and Researcher Plan options when you want more). - **A hybrid workflow**: edit in code, or use a visual editor when you want velocity. --- ## For researchers & labs - **Lab sites and academic profiles** (people, publications, projects, news) - **Citable output** with BibTeX/DOI workflows - **Notebooks + LaTeX** for technical writing that actually renders ## For data scientists & AI engineers - **Project docs** and technical blogs without heavy JavaScript stacks - **Notebook-first publishing** (`.ipynb`) for reports, tutorials, and results - **Knowledge bases** and internal docs that stay searchable and maintainable ## For teams & orgs - **Consistent sites** across teams with templates + blocks - **Lower risk upgrades** with clear versioning + migration guidance - **Support options** when you need fast answers --- ## 🧠 Edit the way you like (code-first, visual when you want it) - **Code-first**: Markdown/YAML + Hugo templates for full control. - **Visual editing (Researcher Plan)**: **Ownable CMS** in VS Code for drag-and-drop blocks, previews, and safer config edits. - **AI automation (Researcher Plan)**: spend less time on formatting, YAML fixes, imports, and maintenance.

Ownable CMS in Action

Ownable CMS: Visual editing meets code-first control.

Template previews

Browse Templates →

_{Want to see it working fast? Pick a template and publish in ~60 seconds with the Online Copilot.}
Try a template now →

--- ## 🚀 Get Started ### Option 1: The Online Copilot (Fastest) Ideal for **founders, labs, and startups**. Launch a site in minutes. 👉 [**Start Free in Browser**](https://hugoblox.com/start?utm_source=github&utm_medium=readme&utm_content=get_started_browser) ### Option 2: Ownable CMS (Best for Data/AI teams) The power of a visual website builder, directly inside VS Code. 1. **Install** [Ownable CMS from the Marketplace](https://marketplace.visualstudio.com/items?itemName=ownable.ownable). 2. **Open** any HugoBlox project folder. 3. **Click** the Ownable CMS icon in the menu to start visually editing. ### Option 3: The CLI (For DevOps/Eng) Scaffold a new project locally. ```bash # Requires Hugo Extended & Node.js npm install -g hugoblox hugoblox create site ``` Need guides and best practices? See the docs: [**docs.hugoblox.com**](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme&utm_content=docs) --- ## ✅ Stability & upgrades (because your site should not break) - **Pin versions** to keep production stable. - **Upgrade with confidence** using migration notes and upgrade guides. - **Customize safely**: prefer configuration and blocks over fragile template overrides when possible. - **Catch config issues early (Researcher Plan)**: visual editing + validation reduces YAML/front matter mistakes. See the docs for upgrade guidance: [**docs.hugoblox.com**](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme&utm_content=upgrade_guidance) ## ⚡️ Unlock Automations & Premium HugoBlox is **Open Core**. The **Free Kit** is production-grade and you will always own your data and code. The Free Kit includes: - **[Ownable CMS](https://marketplace.visualstudio.com/items?itemName=ownable.ownable) Core**: Visual site configuration, theming, and content editing - **Templates + blocks** for portfolios, labs, docs, and landing pages - **Markdown/YAML-first workflow** with Hugo + Tailwind performance - **Notebook + LaTeX support** for technical publishing - **Community support** via docs, GitHub issues, and Discord ### 🤖 Pro (Automation) Upgrade to **Pro** for [Ownable CMS](https://marketplace.visualstudio.com/items?itemName=ownable.ownable) (requires extension login) when you want automation and lower maintenance overhead: - **Less time debugging YAML** (Fix-it Bot + safer config editing) - **Less time formatting citations** (Magic Import + publication automation) - **Less time dealing with upgrades** (guided maintenance workflows) - **More velocity** (visual editing + previews in VS Code) | Feature | **Free Kit** (Open Source) | **Pro** (Automation) | | :--- | :---: | :---: | | **Site Ownership** | ✅ 100% Yours | ✅ 100% Yours | | **Visual Page Editor** | ❌ | **✅ Included** | | **AI Assistant** | ⏳ Trial | **✅ Included** | | **Auto Sync with GitHub** | ❌ | **✅ Included** | | **AI "Fix-It" Bot** (Auto-fix YAML) | ❌ | **✅ Unlimited** | | **Magic Import** (BibTeX/DOI -> Page) | ⏳ Trial | **✅ Unlimited** | | **CV Generator** (Site -> PDF Resume) | ❌ | **✅ Included** | | **Private Discord** | ❌ | ✅ | | **Support Open Research** | 💜 | **🏆 Hero Status** | 👉 [**View Full Feature Matrix**](https://hugoblox.com/pricing?utm_source=github&utm_medium=readme&utm_content=pricing_matrix) • [**Get Pro**](https://hugoblox.com/pricing?utm_source=github&utm_medium=readme&utm_content=cta_pro) > "Ownable CMS saved me **40+ hours** on my lab site. Visual edits + BibTeX auto-updates = **citations up 3×**." >
— **Dr. Sarah Yang**, AI Researcher ### 🎨 HugoBlox Premium **Get the complete kit.** Instant access to premium templates, blocks, and community support to help you launch faster. | Feature | Open Source | **HugoBlox Premium** | | :--- | :---: | :---: | | **Core Framework** | ✅ | ✅ | | **Premium Templates** (SaaS, Lab) | ❌ | **✅ Included** | | **Premium Blocks** | ❌ | **✅ Included** | | **Remove Attribution?** | ❌ | **✅ Included** | | **Private Discord** | ❌ | ✅ | | **Support Open Research** | 💜 | **🏆 Hero Status** | 👉 [**Get Premium Templates Bundle**](https://hugoblox.com/premium?utm_source=github&utm_medium=readme&utm_content=cta_premium) > "Launched my startup site with built-in docs in **10 minutes**. The premium block system is genius; onboarding time dropped 60%." >
— **Alexandre Rodrigues**, Founder --- ## 🏢 Org-ready (without the enterprise bloat) - **Deploy anywhere**: static output works with your existing infra. - **Lower ops surface area**: no runtime app to patch. - **Procurement-friendly options**: priority support and commercial features when you need them. --- ## 🗣️ Community & Support We are a community of 150,000+ researchers, engineers, and creators. - **Need Help?** Join the [Discord Server](https://discord.gg/z8wNYzb) or search the [Documentation](https://docs.hugoblox.com/). - **Found a Bug?** Open an [Issue](https://github.com/HugoBlox/kit/issues). - **Want to Contribute?** Read our [Contributing Guide](./CONTRIBUTING.md). ### Sponsors Help us keep open-source sustainable. [**❤️ Sponsor on GitHub**](https://github.com/sponsors/gcushen) | [**🏢 Become a Partner**](https://github.com/sponsors/gcushen) --- ## License Copyright © 2016-Present [**Lore Labs**](https://lore.tech/?utm_source=github&utm_medium=readme). Released under the [MIT License](./LICENSE.md).

_{HugoBlox™ is a trademark of Lore Labs.}