Skip to content

chemicallang/chemical

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Chemical logo

The Chemical Programming Language

Website | Docs | Changelog | Speed | Contributing & compiler design

Sponsor Patreon Discord X

πŸš€ Overview

Chemical is an innovative, performant, type-safe, and user-friendly programming language with a low memory footprint. It comes with first-class tooling out of the box, all customizable by developers.


Important

Chemical is in pre-alpha state, expect breaking changes and do not use in production.


βš™οΈ Installation

  1. Download & Extract the latest ZIP from the Releases page.
  2. Inside the folder, run ./chemical configure or ./chemical.exe configure
  3. Verify by running chemical -v

🌟 Features

  • Easy to Learn: Master in under a week.
  • Great IDE Support: LSP with syntax highlighting, completions, diagnostics, and more.
  • Compile-Time Evaluation: Powerful comptime features.
  • Low Memory Footprint: Tiny executables, no garbage collector.
  • Multiple Backends: LLVM & C (both fully functional).
  • C Interop: Translate between C & Chemical.
  • Flexible Build System: Custom DSL for builds and modules.

πŸ“Š Progress & Roadmap

Component Status
Lexer, Parser, Sym Res βœ…
Native Codegen (LLVM) βœ…
C Translation & TCC JIT βœ…
Basic Build System βœ…
Basic Multi-threading βœ…
Basic LSP βœ…
Standard Library & Docs πŸ”„ In Progress
Embedded Languages πŸ”„ In Progress
Advanced LSP Support πŸ”„ Planned
Memory Management & Safety πŸ”„ Partial
Advanced Build System Support πŸ”„ Planned
Comptime Features πŸ”„ Planned
Compiler Plugins πŸ”„ Planned
Mobile & Web Support πŸ”„ Planned

πŸ“š Language Features

These features should give you an idea about features we have worked on

  • C-like syntax with structs & namespaces
  • Arrays, enums, unions
  • Native lambdas (with capture)
  • Macros & annotations
  • Implicit & explicit casting
  • Extension functions (like Kotlin)
  • Raw pointers & memory control
  • Full constructors & destructors
  • Explicit copying (.copy() required)
  • Comptime support & generics
  • Overloading, variants, type aliases
  • Trait & impl (Rust-like)
  • Name mangling & conflict detection

πŸ› οΈ Build (From Source)

Requirements

  • 8–16β€―GB RAM
  • C++ toolchain (for LSP)
  • LLVM (for compiler)
  • CLion or other IDE

Building Tiny CC Based Compiler Project (easy, fast)

  1. Clone this repo
  2. Inside the repo, run ./scripts/configure.sh (on windows, git bash must be installed)
  3. Open the repo in IDE (in CLion, you'll get automatic build configurations) or build using cmake

LSP also depends on Tiny CC Based Compiler Project and is built similarly

Building LLVM Based Compiler Project (takes time)

  1. Clone chemical-bootstrap repo in this organization (contains LLVM/CLANG)
  2. Run build scripts (./build.bat / ./build) (this builds LLVM)
  3. Inside it, clone this repo
  4. Open this repo directory in terminal
  5. Run the configure script using ./scripts/configure.sh (on windows, bash must be installed, usually comes with git)
  6. Open the repo in CLion

LSP

  1. For LSP: clone chemical-vscode.
  2. There's a run configuration for compiling and launching extension
  3. Build and Launch the LSP server before launching the extension, The extension detects running lsp executable at port automatically

Open an issue for any build errors.


🎯 Vision & Design Goals

Compiler plugins and language extensions β€” Scalability

Chemical exists to let you embed complex, domain-specific syntax into the language via compiler plugins. Extensions are first-class: add new syntax and behaviors without touching the core. Tooling (syntax highlighting, editor parsing) must continue to work for extended syntax. Scalability and extensibility are part of Chemical’s DNA.

Comprehensive features

Real projects frequently need features a language didn’t originally include. Chemical aims to provide the capabilities you actually need while avoiding β€œsyntax pollution.” Powerful, composable abstractions for library authors and power users come with sensible defaults and a gentle learning curve for beginners. The goal: lots of capability, minimal surprise.

Memory safety β€” without the cost of simplicity

Long-term, Chemical will promote memory safety while keeping the language simple to use. Safety is a priority but not yet fully enforced β€” the initial focus is on core functionality and tooling. Once the core is stable, compiler-enforced safety checks will be added progressively; the beta compiler will enforce baseline safety guarantees.


🀝 Contributing

We welcome all contributions! See CONTRIBUTING.md for guidelines.


πŸ“„ License

Chemical compiler is MIT-licensed and will remain open source. Use it freelyβ€”credit is appreciated but not required.


About

High Performance Native Programming Language With Minimal Syntax

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published