# handbook
**Repository Path**: mirrors_ultralytics/handbook
## Basic Information
- **Project Name**: handbook
- **Description**: A guide to Ultralytics' mission, vision, values, and practices, providing key insights and resources for aligning with our goals.
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-15
- **Last Updated**: 2026-02-08
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 📚 Ultralytics Handbook
Welcome to the **Ultralytics Handbook repository**! This repository houses the source files for the official [Ultralytics Handbook](https://handbook.ultralytics.com/) - your comprehensive guide to our **mission, vision, values, and operational practices**. Built with [Zensical](https://zensical.org/) (a modern static site generator by the creators of Material for MkDocs), the Handbook is continuously deployed via [Vercel](https://vercel.com/) to [handbook.ultralytics.com](https://handbook.ultralytics.com/).
[](https://github.com/ultralytics/handbook/actions/workflows/links.yml)
[](https://github.com/ultralytics/handbook/actions/workflows/format.yml)
[](https://handbook-ultralytics.vercel.app/)
[](https://www.jsdelivr.com/package/gh/ultralytics/llm)
[](https://discord.com/invite/ultralytics)
[](https://community.ultralytics.com/)
[](https://reddit.com/r/ultralytics)
This Handbook serves as a **living document**, evolving alongside Ultralytics' growth. It aims to align team members, contributors, and the wider community with the core principles guiding our work in [artificial intelligence (AI)](https://www.ultralytics.com/glossary/artificial-intelligence-ai) and [computer vision](https://www.ultralytics.com/glossary/computer-vision-cv). Whether you're new to Ultralytics or a seasoned team member, this resource provides insights into everything from our company philosophy to detailed workflows and operational processes, including our approach to [machine learning operations (MLOps)](https://www.ultralytics.com/glossary/machine-learning-operations-mlops).
**New team members?** Start with our [Onboarding Guide](https://handbook.ultralytics.com/people/onboarding/) for your first 90 days roadmap.
## 🧰 Technology Stack
- **[Zensical](https://zensical.org/)** - Modern static site generator (by the creators of Material for MkDocs)
- **[MkDocs Ultralytics Plugin](https://github.com/ultralytics/mkdocs)** - Custom features and integrations
- **[Ultralytics Chat](https://github.com/ultralytics/llm)** - Realtime conversational AI with open-source [chat.js](https://github.com/ultralytics/llm) implementation
- **[Vercel](https://vercel.com/)** - Hosting and deployment
- **[GitHub Actions](https://github.com/features/actions)** - CI/CD automation
## 🛠️ Installation
[](https://pypi.org/project/ultralytics/)
[](https://clickpy.clickhouse.com/dashboard/ultralytics)
[](https://pypi.org/project/ultralytics/)
To build and develop the Handbook locally, install dependencies:
```bash
pip install zensical mkdocs-ultralytics-plugin
```
This installs [Zensical](https://zensical.org/) - a modern static site generator built by the creators of Material for MkDocs - and our custom plugin for enhanced documentation features.
## 🚀 Local Development
Build and serve the Handbook locally with live reload:
```bash
zensical serve
```
The site will be available at `http://127.0.0.1:8000`. Changes to source files trigger automatic rebuilds.
### Development Commands
- **`zensical serve`** - Start development server with live reload
- **`zensical build`** - Build static site to `site/` directory
## 📤 Deployment
The Handbook automatically deploys to [handbook.ultralytics.com](https://handbook.ultralytics.com/) via [Vercel](https://vercel.com/) when changes are pushed to the `main` branch.
## 💡 Contributing
We welcome contributions to the Ultralytics Handbook! Your input helps keep our documentation accurate, comprehensive, and useful.
### How to Contribute
1. **Fork the repository** and create a feature branch
2. **Make your changes** to Markdown files in `docs/en/`
3. **Test locally** with `zensical serve`
4. **Submit a pull request** with clear description of changes
5. **Follow our style guide** (consistent with existing pages)
### Contribution Guidelines
- Use clear, concise language aligned with the handbook's professional tone
- Follow the existing structure and formatting (120-character lines, emoji usage)
- Include proper frontmatter (description and keywords) on all pages
- Test all internal links and ensure proper navigation
- Use tables, admonitions, and formatting consistently with other pages
See our [Contributing Guide](https://docs.ultralytics.com/help/contributing/) for detailed information.
[](https://github.com/ultralytics/ultralytics/graphs/contributors)
## 📂 Repository Structure
```
handbook/
├── docs/
│ ├── en/ # English documentation
│ │ ├── index.md # Homepage
│ │ ├── introduction.md # Handbook introduction
│ │ ├── mission-vision-values/ # Company foundation
│ │ ├── finance/ # Financial policies
│ │ ├── tools/ # Hardware & software
│ │ ├── people/ # HR policies
│ │ ├── workflows/ # Development processes
│ │ ├── contributions/ # Community guidelines
│ │ ├── goals/ # OKRs and company goals
│ │ ├── faq/ # Common questions
│ │ ├── legal/ # Legal & compliance
│ │ └── security/ # Security policies
│ └── overrides/ # Theme customizations
├── .github/
│ └── workflows/ # CI/CD automation
├── mkdocs.yml # MkDocs configuration
├── pyproject.toml # Python project config
├── requirements.txt # Python dependencies
└── README.md # This file
```
## 📄 License
Ultralytics offers two licensing options:
- **AGPL-3.0 License**: Ideal for students, researchers, and enthusiasts passionate about open collaboration. This [OSI-approved](https://opensource.org/license/agpl-v3) open-source license promotes transparency and community involvement. See the [LICENSE](LICENSE) file for details.
- **Enterprise License**: For commercial applications, this license permits seamless integration of Ultralytics software into commercial products, bypassing AGPL-3.0 copyleft requirements. Inquire about an [Ultralytics Enterprise License](https://www.ultralytics.com/license).
## ✉️ Contact
For bug reports and feature requests related to the Ultralytics Handbook, please visit [GitHub Issues](https://github.com/ultralytics/handbook/issues). For questions, discussions, and community support, join our active communities on [Discord](https://discord.com/invite/ultralytics), [Reddit](https://www.reddit.com/r/ultralytics/), and the [Ultralytics Community Forums](https://community.ultralytics.com/). We're here to help with all things Ultralytics!
