MaterialCraft is an open-source, high-performance solution engineered to solve foundational workflow challenges in the Rust ecosystem. Built on local-first principles to ensure privacy, performance, and complete data ownership, it provides a unified architecture for modern developers and technical power users.
How It Works
Point MaterialCraft at your target workspace and initiate the workflow. The system operates through structured phases:
Inspect & Study: Deeply analyzes target structures, specifications, and project metadata without invasive alterations.
Build & Synthesize: Orchestrates dedicated workers to compile or generate verified project modules in accordance with user requirements.
Validate & Diff: Performs automated parity checks against source baselines to flag discrepancies and ensure fidelity.
Ready & Export: Launches live interactive previews and outputs deterministic production artifacts to local storage.
Supported Platforms: macOS (Apple Silicon & Intel), Windows 10/11 x64, Linux
System Requirements
Specification
Minimum Requirement
Recommended Specification
Operating System
macOS 12.0+ / Windows 10 x64 / Ubuntu 22.04
macOS 14.0+ Sonoma / Windows 11 x64
Processor Architecture
4-Core x86_64 or Apple Silicon M1
8-Core Apple Silicon / Core i7+
Memory (RAM)
4 GB Unified Memory
16 GB+ High-Speed RAM
Disk Space
1 GB free SSD storage
5 GB+ free SSD storage
Installation & Setup Guide
macOS Installation
1
Download verified release installer from CookApps or upstream releases.
2
Drag application package into /Applications.
Windows Installation
1
Download official setup binary (.exe / .msi).
2
Run installer and launch from Start Menu.
Building from Source
bash
git clone https://github.com/storytold/materialcraft.git
cd materialcraft
cargo build --release
cargo run --release
How to Use & Workflow
1
Application Launch: Launch MaterialCraft to initialize runtime state and local storage caches.
2
Configuration & Workspace: Set up local configuration, environment flags, or CLI paths.
3
Execution Workflow: Execute automated pipelines or interact through the visual interface.
4
Data Verification: Review generated outputs stored deterministically in designated directories.
Troubleshooting & Common Issues
Issue: Port or Resource Collision on Startup.
*Cause*: A zombie process or background daemon is holding active port bindings.
*Resolution*: Terminate holding processes before relaunching the application.
Issue: Missing native toolchain dependencies during build.
*Cause*: Host system lacks C++ or platform compilation tools.
*Resolution*: Install Xcode Command Line Tools (macOS) or Visual Studio Build Tools (Windows).
How to Use & Getting Started
## Installation & Setup Guide
### macOS Installation
1. Download verified release installer from CookApps or upstream releases.
2. Drag application package into `/Applications`.
### Windows Installation
1. Download official setup binary (`.exe` / `.msi`).
2. Run installer and launch from Start Menu.
### Building from Source
```bash
git clone https://github.com/storytold/materialcraft.git
cd materialcraft
cargo build --release
cargo run --release
```
Ready to run MaterialCraft?
100% Free & Open-Source native desktop software. Star the repository to support development.
