Attention required in Custom Apps

If you see the Attention Required message, it means Frappe Cloud is unable to fetch the latest updates from the associated GitHub repository for the app.

Cause

This usually happens when the Frappe Cloud GitHub App does not have the required permissions to access the repository.

How to Fix the Permission Issue?

Make sure that the Frappe Cloud GitHub App has the correct permissions from your GitHub settings.

Open your GitHub settings.
Check the installed GitHub applications.
Ensure that Frappe Cloud has access to the required repository.
Retry fetching the latest updates from Frappe Cloud.

Retry Fetching Latest Updates

After updating the GitHub permissions, use the Fetch Latest Updates option to try fetching the latest changes again.

Workaround: Attention Required Error Still Appears

If the issue continues even after removing and adding the app again on Frappe Cloud, follow these steps:

Open your GitHub application settings.
Find the Frappe Cloud GitHub App and click on the Configure option.
You will be redirected to a page with a URL containing a unique installation number.
Copy this installation number or the complete URL.
Raise a support ticket with this information so the issue can be resolved quickly.

Note

Providing the GitHub installation number helps the support team identify and resolve the permission issue faster.

Adding Python Dependencies to a Custom App

If your custom app requires additional Python packages such as pandas, you should add them to your dependency file instead of manually installing them using commands like:

pip install pandas

Python dependencies should be defined in either:

pyproject.toml file under the dependencies section
requirements.txt file in the root directory of your custom app

Important

Only one dependency file should be used. Do not maintain both pyproject.toml and requirements.txt for the same dependencies.

Example: Adding Dependencies in pyproject.toml

[project]
name = "insights"
authors = [
    { name = "Powerful Reporting Tool for Frappe Apps", email = "hello@frappe.io"}
]
description = "Open Source Business Intelligence Tool"
requires-python = ">=3.10"
readme = "README.md"
dynamic = ["version"]
dependencies = [
    "pandas~=2.3.3",
    "SQLAlchemy==2.0.41",
    "python-telegram-bot==21.4",
    "duckdb~=1.4.3",
    "sqlglot<28.0.0"
]

Reference

For more examples, you can refer to the ERPNext pyproject.toml configuration.

Rating: 0 / 5 (0 votes)