2.1 Requirements and Installation

Software

This repository targets Frappe v16 (>=16.0.0-dev,<17.0.0) and declares Python >=3.14,<3.15. Install compatible ERPNext and HRMS apps on the same site; the app declares both as required dependencies. Use the requirements of the release you actually deploy when maintaining another branch.

A self-hosted installation needs a working Bench environment, database, Redis, workers, and scheduler. This guide begins with an existing Bench and site; it does not describe operating-system installation.

Farm preparation

Before recording transactions, prepare:

• Company, currency, chart of accounts, and appropriate stock difference accounts.
• Livestock houses and feed/produce stores as Company Warehouses.
• Livestock, feed, medicine, and produce Items with verified stock UOMs and conversions.
• Users, roles, and an active Employee for each Daily Farm Entry operator.
• Opening stock or receipt documents establishing actual animal and feed inventory.

Prepare verified hatch dates and breeder target tables if using performance profiles. Agree alert thresholds with farm management before enabling rules.

Production Setup

Managed Hosting

You can download the app from Frappe Cloud, a simple, user-friendly and sophisticated open-source platform to host Frappe applications with peace of mind.

It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments.

Development Setup

Manual Installation

Install compatible ERPNext and HRMS first. From the Bench directory, fetch the repository and install it on your site. Replace all placeholders, including the branch, with your deployment values.

bench get-app https://github.com/navariltd/livestock-management.git
bench --site YOUR_SITE install-app livestock_management