https://github.com/ultralytics/handbook
A guide to Ultralytics' mission, vision, values, and practices, providing key insights and resources for aligning with our goals.
https://github.com/ultralytics/handbook
ai culture employees goals handbook mission practices ultralytics values vision yolo
Last synced: 4 months ago
JSON representation
A guide to Ultralytics' mission, vision, values, and practices, providing key insights and resources for aligning with our goals.
- Host: GitHub
- URL: https://github.com/ultralytics/handbook
- Owner: ultralytics
- License: agpl-3.0
- Created: 2024-10-13T19:08:57.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-01-29T15:04:06.000Z (5 months ago)
- Last Synced: 2025-01-29T16:21:43.299Z (5 months ago)
- Topics: ai, culture, employees, goals, handbook, mission, practices, ultralytics, values, vision, yolo
- Homepage: https://handbook.ultralytics.com
- Size: 1.79 MB
- Stars: 12
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📚 Ultralytics Handbook
Welcome to the **Ultralytics Handbook repository**, the source for all the content that forms the official [Ultralytics Handbook](https://handbook.ultralytics.com/). This repository contains Markdown files that outline our **mission, vision, values, and internal practices**, and is designed to provide clarity on how Ultralytics operates. The Handbook is built using **MkDocs Material** and is continuously updated to reflect the latest company guidelines. It is deployed via GitHub Pages to [https://handbook.ultralytics.com](https://handbook.ultralytics.com/).
[](https://github.com/ultralytics/handbook/actions/workflows/pages/pages-build-deployment)
[](https://github.com/ultralytics/handbook/actions/workflows/links.yml)
[](https://github.com/ultralytics/handbook/actions/workflows/format.yml)
This Handbook serves as a **living document**—evolving as Ultralytics grows—and is intended to align team members, contributors, and the community with the principles that drive our work. Whether you're new to Ultralytics or a long-standing team member, this Handbook is here to guide you through everything from company philosophy to detailed workflows and processes.
## 🛠️ Installation
[](https://pypi.org/project/ultralytics/)
[](https://www.pepy.tech/projects/ultralytics)
[](https://pypi.org/project/ultralytics/)
To install MkDocs and all the dependencies required to build and develop the Handbook site, simply run:
```bash
pip install black mkdocs-material mkdocs-ultralytics-plugin
```
This command sets up MkDocs and its required plugins, enabling local development and testing of the Handbook documentation.
## 🚀 Building and Serving Locally
Use the following command to build and serve a local instance of the Handbook:
```bash
mkdocs serve
```
This will start a local server with live reloading, allowing you to see updates as you modify the content.
### Key Details:
- **`mkdocs`**: The primary command-line interface for MkDocs.
- **`serve`**: Builds the site and serves it locally with live reload.
To stop the server, simply press `CTRL+C`.
## 📤 Deploying Your Documentation Site
To deploy the Handbook to GitHub Pages or any other hosting platform:
1. Configure your `mkdocs.yml` with deployment settings.
2. Run the following command to deploy:
```bash
mkdocs gh-deploy
```
For a custom domain, update the "Custom domain" settings in your GitHub repository to use [handbook.ultralytics.com](https://handbook.ultralytics.com/).
For further instructions, refer to the [MkDocs deployment guide](https://www.mkdocs.org/user-guide/deploying-your-docs/).
## 💡 Contributing
We welcome contributions to the Ultralytics Handbook! Whether you're helping improve documentation or proposing new ideas, your input is valuable. For more details on how to contribute, please see our [Contributing Guide](https://docs.ultralytics.com/help/contributing/).
## 📜 License
The Ultralytics Handbook is available under the following licenses:
- **AGPL-3.0 License**: Designed for academic and open-source projects. Refer to the [LICENSE](https://github.com/ultralytics/handbook/blob/main/LICENSE) file for specifics.
- **Enterprise License**: Suitable for commercial applications of Ultralytics technologies. Visit [Ultralytics Licensing](https://www.ultralytics.com/license) for more information.
## ✉️ Contact
For any issues, bug reports, or feature requests, please use [GitHub Issues](https://github.com/ultralytics/handbook/issues). You can also join the conversation on [Discord](https://discord.com/invite/ultralytics) to engage with the Ultralytics community and team.
