diff --git a/dev-python/cloup/Manifest b/dev-python/cloup/Manifest
index 8a308fff6e..1ba4a9295f 100644
--- a/dev-python/cloup/Manifest
+++ b/dev-python/cloup/Manifest
@@ -1 +1,2 @@
 DIST cloup-3.0.9.gh.tar.gz 226131 BLAKE2B 9195cff3686b70b1152b610a1725831b41c6a524db0d14d47ba9e3de030133dd3367d3044dad18f9154943378c2c295b5ba24d4e00b2f287c83f9d81f71a7331 SHA512 eb4c4226d841b4f1d51a588ff38a70b290277668cb8a14aa95e950d9fb713788e4baeac93c22f4c76c8adf003f0b274f341ed9cd0e24da3cb197c37008c6403a
+DIST cloup-3.1.0.tar.gz 230167 BLAKE2B ad570f7d3149c6d8f09910cb9fbd17240f043d19d2ae1754ea5d27e5b1e7c0b97256aed999ccc2877b0b56b3215fb5286ed6a705fc9766c321cd3f07b394db85 SHA512 949ef0a65219db3dd90667d561f5ba499631f8b9fe1aab4ad90f0431ed80183477883176175b4904fd35b02cb30ed888aa009dcf5081ec7d51c6ac00a7ccd9e1
diff --git a/dev-python/cloup/cloup-3.1.0.ebuild b/dev-python/cloup/cloup-3.1.0.ebuild
new file mode 100644
index 0000000000..88b147107e
--- /dev/null
+++ b/dev-python/cloup/cloup-3.1.0.ebuild
@@ -0,0 +1,41 @@
+# Copyright 1999-2026 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+DISTUTILS_USE_PEP517=setuptools
+PYTHON_COMPAT=( python3_{12..14} )
+inherit distutils-r1 pypi
+
+DESCRIPTION="Library to build command line interfaces based on Click"
+HOMEPAGE="
+	https://github.com/janLuke/cloup
+	https://pypi.org/project/cloup/
+"
+
+LICENSE="BSD"
+SLOT="0"
+KEYWORDS="~amd64"
+
+DOCS=( README.rst CREDITS.rst examples )
+
+RDEPEND="
+	>=dev-python/click-8.1.0[${PYTHON_USEDEP}]
+	<dev-python/click-9[${PYTHON_USEDEP}]
+"
+
+EPYTEST_PLUGINS=()
+distutils_enable_tests pytest
+
+distutils_enable_sphinx docs \
+	dev-python/furo \
+	dev-python/sphinx-autoapi \
+	dev-python/sphinx-copybutton \
+	dev-python/sphinx-issues \
+	dev-python/sphinx-panels
+
+python_prepare_all() {
+	# Avoid unnecessary and unpackaged sphinx-version-warning
+	sed '/versionwarning.extension/d' -i docs/conf.py || die
+	distutils-r1_python_prepare_all
+}