​
Build with command line

  1. Clone this repository: 
    git clone https://github.com/getcellm/cellm.git
  2. In your terminal, go into the root of the project directory: 
    cd cellm
  3. Install dependencies: 
    dotnet restore
  4. Build the project: 
    dotnet build --configuration Debug

​
Build with Visual Studio

  1. In Visual Studio, go to File > Clone Repository.
  2. Set the Repository Location to https://github.com/getcellm/cellm, the Path to a directory of your choice, and click Clone.
  3. Run the “Excel” configuration. Visual Studio will build Cellm and open Excel. Click on “Enable this add-in for this session only” to load the build into Excel.
To sign the installer, you need the Windows 10 SDK or Windows 11 SDK which includes the sign tool. Run the Visual Studio Installer and modify your Visual Studio installation to include one of these SDKs.

​
Debug with Visual Studio

All Visual Studio’s usual debugging tools works when you run the “Excel” configuration. You can set breakpoints, inspect runtime variables, and view log messages in the Output window. To exercise code, type e.g. =PROMPT("Hello World") in a cell’s formula and run it.

​
Contributing

We welcome contributions to Cellm! This section will guide you through the process.
  1. Fork the repository on GitHub
  2. Create a new branch from main for your feature or bug fix: 
    git checkout -b your-feature-name
  3. Make your changes.
  4. Commit your changes with clear, descriptive commit messages with Conventional Commits prefixes (fix, feat, docs, refactor): 
    git commit -m "feat: descriptive message"
  5. Push your branch to your fork: 
    git push origin your-feature-name
  6. Open a Pull Request (PR) against our main branch

​
Contributor License Agreement (CLA)

You must sign our Contributor License Agreement (CLA). This is a one-time requirement that grants us the necessary rights to use your contributions. The CLA signing process will be automatically initiated when you submit your first PR. Our bot will guide you through the process.

​
Getting Help

If you have questions about contributing:
  • Open a GitHub issue for bug reports or feature discussions
  • Check existing issues and PRs to avoid duplicates
  • Join our community discussions in Discord for general questions
We review all PRs.