{"id":32544403,"url":"https://github.com/rohankishore/promethium","last_synced_at":"2026-03-07T03:31:05.497Z","repository":{"id":319160687,"uuid":"1077784907","full_name":"rohankishore/promethium","owner":"rohankishore","description":"A Python tool for accessing a comprehensive, offline database of elements, isotopes, and chemical properties. Built for students, developers,and researchers.","archived":false,"fork":false,"pushed_at":"2025-10-17T21:03:19.000Z","size":7721,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-05T17:08:37.879Z","etag":null,"topics":["chemical-engineering","chemical-reactions","chemistry","chemistry-education","chemistry-lab","chemistry-molecule","chemistry-solver","element","element-data","elements","hacktoberfest","hacktoberfest-accepted","reaction-solver"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rohankishore.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-16T18:25:40.000Z","updated_at":"2025-12-21T19:59:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b3cb474-8fc1-41b7-8da6-b1d56d875842","html_url":"https://github.com/rohankishore/promethium","commit_stats":null,"previous_names":["rohankishore/promethium"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/rohankishore/promethium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohankishore%2Fpromethium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohankishore%2Fpromethium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohankishore%2Fpromethium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohankishore%2Fpromethium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rohankishore","download_url":"https://codeload.github.com/rohankishore/promethium/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohankishore%2Fpromethium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30206563,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T03:24:23.086Z","status":"ssl_error","status_checked_at":"2026-03-07T03:23:11.444Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chemical-engineering","chemical-reactions","chemistry","chemistry-education","chemistry-lab","chemistry-molecule","chemistry-solver","element","element-data","elements","hacktoberfest","hacktoberfest-accepted","reaction-solver"],"created_at":"2025-10-28T17:59:04.754Z","updated_at":"2026-03-07T03:31:05.457Z","avatar_url":"https://github.com/rohankishore.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"1763\" height=\"550\" alt=\"Group 2\" src=\"https://github.com/user-attachments/assets/2ec6bc58-490a-46de-b61a-c0751a5fbb4e\" /\u003e\n\n  \u003ch1\u003ePromethium 🧪\u003c/h1\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eUnleash the elements. A Pythonic interface to a rich, offline database of chemical information.\u003c/strong\u003e \u003cbr\u003e\n    PYPI: https://pypi.org/project/promethium-py/\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://pypi.org/project/promethium-py/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/promethium-py?style=for-the-badge\u0026color=blueviolet\" alt=\"PyPI version\"\u003e\u003c/a\u003e\n    \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.8+-blue.svg?style=for-the-badge\" alt=\"Python version\"\u003e\u003c/a\u003e\n    \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/github/workflow/status/rohankishore/promethium/CI?style=for-the-badge\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n**Promethium** is your go-to periodic table and chemistry toolkit in Python. All data is included for **100% offline use**. No internet connection or API keys are required, making it fast, reliable, and perfect for any environment.\n\n## ✨ Features\n\n-   **Offline First**: All data is bundled with the library. No network calls, ever.\n-   **Comprehensive Element Data**: Access dozens of properties for each element, from atomic mass to electronegativity.\n-   **Chemical Equation Balancer**: Programmatically balance complex chemical reactions with a single function call.\n-   **Intuitive API**: A clean, object-oriented interface that's a joy to use.\n-   **Lightweight \u0026 Fast**: Built for performance using an efficient data-handling backend.\n\n\n## 🚀 Installation\n\nInstall Promethium easily with pip:\n\n```bash\npip install promethium-py\n```\n\n## 💡 Quick Start\nGetting started with Promethium is incredibly simple.\n\nFetching Element Data\nLook up any element by its name, symbol, or atomic number. The returned object gives you access to all its properties.\n\n```python\nfrom promethium_py import element\n\n# Find an element by its name (case-insensitive)\nthorium = element.name(\"Thorium\")\n\nif thorium:\n    print(f\"Name: {thorium.name}\")\n    print(f\"Symbol: {thorium.symbol}\")\n    print(f\"Atomic Mass: {thorium.atomic_mass}\")\n    print(f\"Atomic Radius: {thorium.atomic_radius} pm\")\n    \n# \u003e\u003e\u003e Name: Thorium\n# \u003e\u003e\u003e Symbol: Th\n# \u003e\u003e\u003e Atomic Mass: 232.0377\n# \u003e\u003e\u003e Atomic Radius: 179 pm\n```\n\n### Balancing Chemical Equations\nProvide lists of reactants and products, and let the balancer do the work, returning a dictionary of stoichiometric coefficients.\n\n```python\nfrom promethium_py import balance_equation\n\n# Balance the formation of water\nreactants = ['H2', 'O2']\nproducts = ['H2O']\n\nbalanced = balance_equation(reactants, products)\n\nprint(f\"Reactants: {balanced['reactants']}\")\nprint(f\"Products: {balanced['products']}\")\n\n# \u003e\u003e\u003e Reactants: {'H2': 2, 'O2': 1}\n# \u003e\u003e\u003e Products: {'H2O': 2}\n# This represents the equation: 2H₂ + O₂ ⟶ 2H₂O\n```\n\n### Getting all the Data of an Element\n\n```python\nfrom promethium_py.balancer import balance_equation\nfrom promethium_py.element_handler import ElementFinder\n\n# --- Test element finder ---\nelement_finder = ElementFinder()\n\nth = element_finder.name(\"thorium\")\nif th:\n    print(\"--- Element Information ---\")\n    for key, value in th.__dict__.items():\n        print(f\"{key}: {value}\")\n    print(\"-\" * 20)\n\n\n\n\"\"\"\natomic_radius: 180.0\nblock: f\ndensity: 11.7\ndescription: Grey radioactive metallic element. Belongs to actinoids. Found in monazite sand in Brazil, India and the US. Thorium-232 has a half-life of 1.39x10^10 years. Can be used as a nuclear fuel for breeder reactors. Thorium-232 captures slow Neutrons and breeds uranium-233. Discovered by Jons J. Berzelius in 1829.\ndipole_polarizability: 217.0\nelectron_affinity: nan\nelectronic_configuration: [Rn] 6d2 7s2\nevaporation_heat: 513.7\nfusion_heat: 16.11\ngroup_id: nan\nlattice_constant: 5.08\nlattice_structure: FCC\nname: Thorium\nperiod: 7\nseries_id: 10\nspecific_heat_capacity: 0.118\nsymbol: Th\nthermal_conductivity: nan\nvdw_radius: 245.0\ncovalent_radius_cordero: 206.0\ncovalent_radius_pyykko: 175\nen_pauling: 1.3\nen_allen: nan\njmol_color: #00baff\ncpk_color: #ff1493\nproton_affinity: nan\ngas_basicity: nan\nheat_of_formation: 602.0\nc6: nan\ncovalent_radius_bragg: nan\nvdw_radius_bondi: nan\nvdw_radius_truhlar: nan\nvdw_radius_rt: nan\nvdw_radius_batsanov: 240.0\nvdw_radius_dreiding: nan\nvdw_radius_uff: 339.6\nvdw_radius_mm3: 274.0\nabundance_crust: 9.6\nabundance_sea: 1e-06\nmolcas_gv_color: #00baff\nen_ghosh: 0.10277\nvdw_radius_alvarez: 293.0\nc6_gb: nan\natomic_weight: 232.0377\natomic_weight_uncertainty: 0.0004\nis_monoisotopic: nan\nis_radioactive: 1\ncas: 7440-29-1\natomic_radius_rahm: 288.0\ngeochemical_class: rare earth \u0026 related\ngoldschmidt_class: litophile\nmetallic_radius: nan\nmetallic_radius_c12: nan\ncovalent_radius_pyykko_double: 143.0\ncovalent_radius_pyykko_triple: 136.0\ndiscoverers: Jöns Berzelius\ndiscovery_year: 1828.0\ndiscovery_location: Sweden\nname_origin: Named for Thor, Norse god of thunder.\nsources: Found in various minerals like monazite and thorite.\nuses: Used in making strong alloys. Also in ultraviolet photoelectric cells. It is a common ingredient in high-quality lenses. Bombarded with neutrons make uranium-233, a nuclear fuel.\nmendeleev_number: 16\ndipole_polarizability_unc: 54.0\npettifor_number: 47.0\nglawe_number: 34.0\nmolar_heat_capacity: 27.32\nen_miedema: 3.3\nmiedema_molar_volume: 19.8\nmiedema_electron_density: 2.1\nen_gunnarsson_lundqvist: nan\nen_robles_bartolotti: nan\nproduction_concentration: 80.0\nrelative_supply_risk: 7.6\nreserve_distribution: 31.0\npolitical_stability_of_top_producer: 10.8\npolitical_stability_ of_top_reserve_holder: 56.6\ntop_3_producers: 1) India  2) Brazil  3) Malaysia\ntop_3_reserve_holders: 1) USA  2) Australia  3) India\nrecycling_rate: nan\nsubstitutability: High\nprice_per_kg: 287.0\nen_mullay: nan\nname_lower: thorium\natomic_number: 90\n\n\"\"\"\n```\n\n## 🗺️ Roadmap\n1. [ ] Isotope data integration\n2. [ ] Compound property calculator (molecular weight, etc.)\n3. [ ] Thermodynamic data module\n4. [ ] 2D/3D molecule visualization hooks\n\n## 🤝 Contributing\nContributions, issues, and feature requests are welcome! Feel free to check the issues page.\n\n## 📄 License\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frohankishore%2Fpromethium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frohankishore%2Fpromethium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frohankishore%2Fpromethium/lists"}