CarbonCraft v1.0.0

Status: Stable Release

Summary

Welcome to CarbonCraft v1.0.0! This is the first stable release following the v0.9.0-beta.1 preview. CarbonCraft is an interactive 3D molecular builder for hydrocarbon derivatives, combining Ursina, Panda3D rendering, and RDKit chemistry tools to let you build and inspect molecules in a live 3D environment.

Highlights

• Interactive 3D Builder: Drag-and-drop elements to build molecules dynamically.
• RDKit Integration: Live SMILES generation, valency checking, and structure sanitization.
• PubChem Lookup: Automatic fetching of IUPAC names via the PubChem API.
• Improved Visuals: Lit shaders, Z-aligned cylinder bonds, and high-poly sphere atoms using Panda3D.
• Windows Executable Support: Easy packaging via included PyInstaller scripts.

Installation / Usage

Windows Executable Build

You will find the pre-built executable zipped in the release assets below.

If you prefer to build it yourself from source, ensure you have the virtual environment activated, then run:

PowerShell

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
.\scripts\build_pyinstaller.ps1

Command Prompt

scripts\build_pyinstaller.bat

The compiled application will be generated in the dist\CarbonCraft directory.

Dependencies / Environment

See requirements.txt for exact pins.

• Python 3.10+
• numpy, Panda3D, panda3d-gltf, panda3d-simplepbr, ursina
• rdkit, PubChemPy

Known Issues

• Highly strained or cyclical structures may occasionally fail RDKit's 3D embedding routine.
• Requires an active internet connection for IUPAC name retrieval. Without it, the UI will display "Offline/Unknown".

Full Changelog: v0.9.0-beta.1...v1.0.0

CarbonCraft_v0.9.0-beta.1

Summary

This pre-release provides an early, feature-rich preview of CarbonCraft: an interactive 3D molecular builder for hydrocarbon derivatives. It focuses on visuals, basic RDKit integration, PubChem lookup, and a packaged Windows build workflow. Use this release to test workflows and provide feedback; expect UI/behavior changes before stable release.

Highlights

• Interactive 3D molecule builder UI using Ursina + Panda3D rendering improvements.
• RDKit integration for SMILES generation and local chemistry operations.
• PubChem lookup for IUPAC names.

What to test (short checklist)

• Launch and confirm the main UI opens.
• Add atoms and bonds; verify SMILES output generation.
• Try fetching an IUPAC name from PubChem (requires internet).
• Test drag/drop and bond-order cycling behavior.
• Report performance or rendering issues (include OS and GPU info).

Known issues (not exhaustive)

• Some molecules may fail RDKit sanitization or 3D embedding depending on valency or geometry constraints — workaround: simplify structure or adjust bonds before embedding.
• Some assets or shaders may behave differently across GPU drivers.

How to report bugs / provide feedback

Please open a new issue on GitHub and include:

• OS and version
• Steps to reproduce
• Screenshots or short screencast if UI-related

Tag maintainers/contacts: @Mohamed-dev1 @yousef-fayad

Release notes / testing credits

• Tested briefly on Windows
• Future releases will improve UI, work on adding more features, and include Cyclic hydrocarbons.