diff --git a/dev-python/osc-lib/Manifest b/dev-python/osc-lib/Manifest
index cb2cc6bc904ee..a12d9d1608606 100644
--- a/dev-python/osc-lib/Manifest
+++ b/dev-python/osc-lib/Manifest
@@ -1 +1,2 @@
 DIST osc-lib-3.2.0.tar.gz 99180 BLAKE2B dfa1bb53245599154feea88733e9bfda0251ccf21aaa1e661f862215e3dc0105fdfaf2d916e2454b93bbe8c5c76f70cdf8bf0fb7a3f71756e51c3b3d3159abd7 SHA512 3942ebfa17b2f292c3703dae9f9edf4b8fef256fbd9f3df4be71451b2920f37720b195d25b945be0f69cb8c93cda1652926c7015a511a3e8e92833be3623f295
+DIST osc_lib-4.0.0.tar.gz 101874 BLAKE2B a2ab33ca2b3cfe297664be940dff6a158c62de0d1c45203a1fd418fbf119d44bd52063c6d49e21cbd1afc43163d7d9bfa8d77e41b559b6e87cc0933d8da3c7b9 SHA512 bd6ccfcecb4d4a026a2900e9f472da89b3c3cbc9e0396f1f9403a8aeb4ff6756c80ba655fa7c6b0d88321ab31f05fb0db506916ab0edcc979370df76862b7c52
diff --git a/dev-python/osc-lib/osc-lib-4.0.0.ebuild b/dev-python/osc-lib/osc-lib-4.0.0.ebuild
new file mode 100644
index 0000000000000..6bd26bad27c08
--- /dev/null
+++ b/dev-python/osc-lib/osc-lib-4.0.0.ebuild
@@ -0,0 +1,50 @@
+# Copyright 1999-2025 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+DISTUTILS_USE_PEP517=setuptools
+PYTHON_COMPAT=( python3_{10..13} )
+
+inherit distutils-r1 pypi
+
+DESCRIPTION="A package of common support modules for writing OSC plugins"
+HOMEPAGE="
+	https://opendev.org/openstack/osc-lib/
+	https://github.com/openstack/osc-lib/
+	https://pypi.org/project/osc-lib/
+"
+
+LICENSE="Apache-2.0"
+SLOT="0"
+KEYWORDS="~amd64 ~arm ~arm64 ~riscv ~x86 ~amd64-linux ~x86-linux"
+
+RDEPEND="
+	>=dev-python/cliff-4.9.0[${PYTHON_USEDEP}]
+	>=dev-python/keystoneauth1-5.10.0[${PYTHON_USEDEP}]
+	>=dev-python/openstacksdk-0.15.0[${PYTHON_USEDEP}]
+	>=dev-python/oslo-i18n-3.15.3[${PYTHON_USEDEP}]
+	>=dev-python/oslo-utils-3.33.0[${PYTHON_USEDEP}]
+	>=dev-python/requests-2.14.2[${PYTHON_USEDEP}]
+	>=dev-python/stevedore-1.20.0[${PYTHON_USEDEP}]
+"
+BDEPEND="
+	>dev-python/pbr-2.1.0[${PYTHON_USEDEP}]
+	test? (
+		>=dev-python/fixtures-3.0.0[${PYTHON_USEDEP}]
+		>=dev-python/oslotest-3.2.0[${PYTHON_USEDEP}]
+		>=dev-python/requests-mock-1.2.0[${PYTHON_USEDEP}]
+		>=dev-python/statsd-3.3.0[${PYTHON_USEDEP}]
+		>=dev-python/testscenarios-0.4[${PYTHON_USEDEP}]
+		>=dev-python/testtools-2.2.0[${PYTHON_USEDEP}]
+	)
+"
+
+distutils_enable_tests unittest
+
+src_prepare() {
+	# need to skip all tests under TestTagHelps class
+	# checks exact help message, based on another unittest runner
+	sed -e '179,$s/test_add_tag_/_&/' -i osc_lib/tests/utils/test_tags.py || die
+	distutils-r1_src_prepare
+}