ciel

Name	ciel JSON
Version	2.3.1 JSON
	download
home_page	https://github.com/fossi-foundation/ciel
Summary	An PDK builder/version manager for PDKs in the open_pdks format
upload_time	2025-10-08 10:25:32
maintainer	None
docs_url	None
author	Mohamed Gaber
requires_python	>=3.8
license	Apache-2.0
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            <h1 align="center">🌌 Ciel</h1>
<p align="center">
    <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0"/></a>
    <img src="https://github.com/fossi-foundation/ciel/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI Status" />
    <a href="https://fossi-chat.org"><img src="https://img.shields.io/badge/Community-FOSSi%20Chat-1bb378?logo=element" alt="Invite to FOSSi Chat"/></a>
    <a href="https://github.com/psf/black"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black"/></a>
</p>

<p align="center">Ciel is a version manager (and builder) for builds of open-source process design kits (PDKs).</p>

# Requirements
* Python 3.8+ with PIP
* macOS or GNU/Linux

## macOS
Get [Homebrew](https://brew.sh) then:

```sh
brew install python3
```

## Debian and Ubuntu
Debian 11+ or Ubuntu 20.04+ is required.

```sh
sudo apt-get update
sudo apt-get install python3 python3-pip
```

## RHEL and Derivatives
RHEL 8+ or compatible operating system required.
```sh
sudo yum install -y python3 python3-pip
```


# Installation and Upgrades
```sh
# To install (or upgrade)
python3 -m pip install --user --upgrade --no-cache-dir ciel

# To verify it works
ciel --version
```

# About the builds
In its current inception, ciel supports builds of **sky130** and **gf180mcu** PDKs using [Open_PDKs](https://github.com/efabless/open_pdks), including the following libraries:

|sky130|gf180mcu|ihp-sg13g2|
|-|-|-|
|sky130_fd_io|gf180mcu_fd_io|sg13g2_io|
|sky130_fd_pr|gf180mcu_fd_pr|sg13g2_pr|
|sky130_fd_pr_reram|gf180mcu_fd_pr|sg13g2_pr|
|sky130_fd_sc_hd|gf180mcu_fd_sc_mcu7t5v0|sg13g2_stdcell|
|sky130_ml_xx_hd|gf180mcu_fd_sc_mcu9t5v0|-|
|sky130_fd_sc_hvl|gf180mcu_osu_sc_gp9t3v3|-|
|sky130_fd_sc_lp|gf180mcu_osu_sc_gp12t3v3|-|
|sky130_fd_sc_ls|-|-|
|sky130_fd_sc_ms|-|-|
|sky130_fd_sc_hs|-|-|
|sky130_sram_macros|gf180mcu_fd_ip_sram|sg13g2_sram|

Builds for sky130 and gf180mcu are identified by their [**open_pdks**](https://github.com/rtimothyedwards/open_pdks) commit hashes. Builds for ihp-sg13g2 are identified by their [**IHP-Open-PDK**](https://github.com/ihp-gmbh/ihp-open-pdk) commit hashes.

# Usage
Ciel requires a so-called **PDK Root**. This PDK root can be anywhere on your computer, but by default it's the folder `~/.ciel` in your home directory. If you have the variable `PDK_ROOT` set, ciel will use that instead. You can also manually override both values by supplying the `--pdk-root` commandline argument.

## Listing All Available PDKs
To list all available pre-built PDK families hosted in this repository, you can just invoke `ciel ls-remote --pdk-family <pdk-family>`.

```sh
$ ciel ls-remote --pdk-family sky130
Pre-built sky130 PDK versions
├── 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)
├── e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29) (installed)
├── 41c0908b47130d5675ff8484255b43f66463a7d6 (2022.04.14) (installed)
├── 660c6bdc8715dc7b3db95a1ce85392bbf2a2b195 (2022.04.08)
├── 5890e791e37699239abedfd2a67e55162e25cd94 (2022.04.06)
├── 8fe7f760ece2bb49b1c310e60243f0558977dae5 (2022.04.06)
└── 7519dfb04400f224f140749cda44ee7de6f5e095 (2022.02.10)

$ ciel ls-remote --pdk-family gf180mcu
Pre-built gf180mcu PDK versions
└── 120b0bd69c745825a0b8b76f364043a1cd08bb6a (2022.09.22)
```

It includes a hash of the commit of the relevant repo used for that particular build, the date that this commit was created, and whether you already installed this PDK and/or if it is the currently enabled PDK.

## Listing Installed PDKs
Typing `ciel ls --pdk-family <pdk-family>` in the terminal shows you your PDK Root and the PDKs you currently have installed.

```sh
$ ciel ls --pdk-family sky130
/home/test/ciel/sky130/versions
├── 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)
├── e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29)
└── 41c0908b47130d5675ff8484255b43f66463a7d6 (2022.04.14)
```

(If you're not connected to the Internet, the release date of the commit will not be included.)


## Downloading and Enabling PDKs
You can enable a particular sky130 PDK by invoking `ciel enable --pdk-family <pdk-family> <open_pdks commit hash>`. This will automatically download that particular version of the PDK, if found, and set it as your currently used PDK.

For example, to activate a build of sky130 using open_pdks `7519dfb04400f224f140749cda44ee7de6f5e095`, you invoke `ciel enable --pdk-family sky130 7519dfb04400f224f140749cda44ee7de6f5e095`, as shown below:

```sh
$ ciel enable --pdk-family sky130 7519dfb04400f224f140749cda44ee7de6f5e095
Downloading pre-built tarball for 7519dfb04400f224f140749cda44ee7de6f5e095… ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
Unpacking…                                                                  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
PDK version 7519dfb04400f224f140749cda44ee7de6f5e095 enabled.
```

## Building PDKs
For special cases, you may have to build the PDK yourself, which Ciel does support.

You'll need Magic installed and in PATH. You can either do that manually or, if you have [Nix](https://nixos.org), invoke `nix shell github:fossi-foundation/nix-eda#magic` before building.

You can invoke `ciel build --help` for more options. Be aware, the built PDK won't automatically be enabled and you'll have to `ciel enable` the appropriate version.

# License
The Apache License, version 2.0. See 'License'.


Ciel is based on [Volare](https://github.com/efabless/volare) by Efabless
Corporation:

```
Copyright 2022-2025 Efabless Corporation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/fossi-foundation/ciel",
    "name": "ciel",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Mohamed Gaber",
    "author_email": "me@donn.website",
    "download_url": "https://files.pythonhosted.org/packages/f0/a6/3d8909ab112fbcf9a2303ea873eee4c987bfaf8d5e0001ba612b47ee5592/ciel-2.3.1.tar.gz",
    "platform": null,
    "description": "<h1 align=\"center\">\ud83c\udf0c Ciel</h1>\n<p align=\"center\">\n    <a href=\"https://opensource.org/licenses/Apache-2.0\"><img src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License: Apache 2.0\"/></a>\n    <img src=\"https://github.com/fossi-foundation/ciel/actions/workflows/ci.yml/badge.svg?branch=main\" alt=\"CI Status\" />\n    <a href=\"https://fossi-chat.org\"><img src=\"https://img.shields.io/badge/Community-FOSSi%20Chat-1bb378?logo=element\" alt=\"Invite to FOSSi Chat\"/></a>\n    <a href=\"https://github.com/psf/black\"><img src=\"https://img.shields.io/badge/code%20style-black-000000.svg\" alt=\"Code Style: Black\"/></a>\n</p>\n\n<p align=\"center\">Ciel is a version manager (and builder) for builds of open-source process design kits (PDKs).</p>\n\n# Requirements\n* Python 3.8+ with PIP\n* macOS or GNU/Linux\n\n## macOS\nGet [Homebrew](https://brew.sh) then:\n\n```sh\nbrew install python3\n```\n\n## Debian and Ubuntu\nDebian 11+ or Ubuntu 20.04+ is required.\n\n```sh\nsudo apt-get update\nsudo apt-get install python3 python3-pip\n```\n\n## RHEL and Derivatives\nRHEL 8+ or compatible operating system required.\n```sh\nsudo yum install -y python3 python3-pip\n```\n\n\n# Installation and Upgrades\n```sh\n# To install (or upgrade)\npython3 -m pip install --user --upgrade --no-cache-dir ciel\n\n# To verify it works\nciel --version\n```\n\n# About the builds\nIn its current inception, ciel supports builds of **sky130** and **gf180mcu** PDKs using [Open_PDKs](https://github.com/efabless/open_pdks), including the following libraries:\n\n|sky130|gf180mcu|ihp-sg13g2|\n|-|-|-|\n|sky130_fd_io|gf180mcu_fd_io|sg13g2_io|\n|sky130_fd_pr|gf180mcu_fd_pr|sg13g2_pr|\n|sky130_fd_pr_reram|gf180mcu_fd_pr|sg13g2_pr|\n|sky130_fd_sc_hd|gf180mcu_fd_sc_mcu7t5v0|sg13g2_stdcell|\n|sky130_ml_xx_hd|gf180mcu_fd_sc_mcu9t5v0|-|\n|sky130_fd_sc_hvl|gf180mcu_osu_sc_gp9t3v3|-|\n|sky130_fd_sc_lp|gf180mcu_osu_sc_gp12t3v3|-|\n|sky130_fd_sc_ls|-|-|\n|sky130_fd_sc_ms|-|-|\n|sky130_fd_sc_hs|-|-|\n|sky130_sram_macros|gf180mcu_fd_ip_sram|sg13g2_sram|\n\nBuilds for sky130 and gf180mcu are identified by their [**open_pdks**](https://github.com/rtimothyedwards/open_pdks) commit hashes. Builds for ihp-sg13g2 are identified by their [**IHP-Open-PDK**](https://github.com/ihp-gmbh/ihp-open-pdk) commit hashes.\n\n# Usage\nCiel requires a so-called **PDK Root**. This PDK root can be anywhere on your computer, but by default it's the folder `~/.ciel` in your home directory. If you have the variable `PDK_ROOT` set, ciel will use that instead. You can also manually override both values by supplying the `--pdk-root` commandline argument.\n\n## Listing All Available PDKs\nTo list all available pre-built PDK families hosted in this repository, you can just invoke `ciel ls-remote --pdk-family <pdk-family>`.\n\n```sh\n$ ciel ls-remote --pdk-family sky130\nPre-built sky130 PDK versions\n\u251c\u2500\u2500 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)\n\u251c\u2500\u2500 e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29) (installed)\n\u251c\u2500\u2500 41c0908b47130d5675ff8484255b43f66463a7d6 (2022.04.14) (installed)\n\u251c\u2500\u2500 660c6bdc8715dc7b3db95a1ce85392bbf2a2b195 (2022.04.08)\n\u251c\u2500\u2500 5890e791e37699239abedfd2a67e55162e25cd94 (2022.04.06)\n\u251c\u2500\u2500 8fe7f760ece2bb49b1c310e60243f0558977dae5 (2022.04.06)\n\u2514\u2500\u2500 7519dfb04400f224f140749cda44ee7de6f5e095 (2022.02.10)\n\n$ ciel ls-remote --pdk-family gf180mcu\nPre-built gf180mcu PDK versions\n\u2514\u2500\u2500 120b0bd69c745825a0b8b76f364043a1cd08bb6a (2022.09.22)\n```\n\nIt includes a hash of the commit of the relevant repo used for that particular build, the date that this commit was created, and whether you already installed this PDK and/or if it is the currently enabled PDK.\n\n## Listing Installed PDKs\nTyping `ciel ls --pdk-family <pdk-family>` in the terminal shows you your PDK Root and the PDKs you currently have installed.\n\n```sh\n$ ciel ls --pdk-family sky130\n/home/test/ciel/sky130/versions\n\u251c\u2500\u2500 44a43c23c81b45b8e774ae7a84899a5a778b6b0b (2022.08.16) (enabled)\n\u251c\u2500\u2500 e8294524e5f67c533c5d0c3afa0bcc5b2a5fa066 (2022.07.29)\n\u2514\u2500\u2500 41c0908b47130d5675ff8484255b43f66463a7d6 (2022.04.14)\n```\n\n(If you're not connected to the Internet, the release date of the commit will not be included.)\n\n\n## Downloading and Enabling PDKs\nYou can enable a particular sky130 PDK by invoking `ciel enable --pdk-family <pdk-family> <open_pdks commit hash>`. This will automatically download that particular version of the PDK, if found, and set it as your currently used PDK.\n\nFor example, to activate a build of sky130 using open_pdks `7519dfb04400f224f140749cda44ee7de6f5e095`, you invoke `ciel enable --pdk-family sky130 7519dfb04400f224f140749cda44ee7de6f5e095`, as shown below:\n\n```sh\n$ ciel enable --pdk-family sky130 7519dfb04400f224f140749cda44ee7de6f5e095\nDownloading pre-built tarball for 7519dfb04400f224f140749cda44ee7de6f5e095\u2026 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501 100% 0:00:00\nUnpacking\u2026                                                                  \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501 100% 0:00:00\nPDK version 7519dfb04400f224f140749cda44ee7de6f5e095 enabled.\n```\n\n## Building PDKs\nFor special cases, you may have to build the PDK yourself, which Ciel does support.\n\nYou'll need Magic installed and in PATH. You can either do that manually or, if you have [Nix](https://nixos.org), invoke `nix shell github:fossi-foundation/nix-eda#magic` before building.\n\nYou can invoke `ciel build --help` for more options. Be aware, the built PDK won't automatically be enabled and you'll have to `ciel enable` the appropriate version.\n\n# License\nThe Apache License, version 2.0. See 'License'.\n\n\nCiel is based on [Volare](https://github.com/efabless/volare) by Efabless\nCorporation:\n\n```\nCopyright 2022-2025 Efabless Corporation\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n     http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "An PDK builder/version manager for PDKs in the open_pdks format",
    "version": "2.3.1",
    "project_urls": {
        "Homepage": "https://github.com/fossi-foundation/ciel",
        "Repository": "https://github.com/fossi-foundation/ciel"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2d9600a24bed8107106cb5f0b17fe6f47807748ae5edc0b17e78a3c3a08b50fc",
                "md5": "5c43d0b1181b5999fd196e1bc161bea2",
                "sha256": "0c76f839b396aa945aafc7eb9518f4be32c718f2f8b99c9af2ca3878eb8f4426"
            },
            "downloads": -1,
            "filename": "ciel-2.3.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5c43d0b1181b5999fd196e1bc161bea2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 38603,
            "upload_time": "2025-10-08T10:25:31",
            "upload_time_iso_8601": "2025-10-08T10:25:31.326739Z",
            "url": "https://files.pythonhosted.org/packages/2d/96/00a24bed8107106cb5f0b17fe6f47807748ae5edc0b17e78a3c3a08b50fc/ciel-2.3.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f0a63d8909ab112fbcf9a2303ea873eee4c987bfaf8d5e0001ba612b47ee5592",
                "md5": "c58592d05ee5e23c3832b3bec795eb39",
                "sha256": "d0afd6b55238e69931e0bfb2cbd64d279ad2c112717355e6e2a296ea9b96671a"
            },
            "downloads": -1,
            "filename": "ciel-2.3.1.tar.gz",
            "has_sig": false,
            "md5_digest": "c58592d05ee5e23c3832b3bec795eb39",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 26551,
            "upload_time": "2025-10-08T10:25:32",
            "upload_time_iso_8601": "2025-10-08T10:25:32.654103Z",
            "url": "https://files.pythonhosted.org/packages/f0/a6/3d8909ab112fbcf9a2303ea873eee4c987bfaf8d5e0001ba612b47ee5592/ciel-2.3.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-08 10:25:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "fossi-foundation",
    "github_project": "ciel",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "ciel"
}