👁 Image
Speckle.Automate.Sdk 3.21.1

Speckle | Sharp | SDK

👁 Twitter Follow
👁 Community forum users
👁 website
👁 docs

Speckle is the first AEC data hub that connects with your favorite AEC tools. Speckle exists to overcome the challenges of working in a fragmented industry where communication, creative workflows, and the exchange of data are often hindered by siloed software and processes. It is here to make the industry better.

.NET SDK, Tests, and Objects

👁 codecov
<a href="https://www.nuget.org/packages/Speckle.Sdk/"><img alt="NuGet Version" src="https://img.shields.io/nuget/v/Speckle.Sdk?label=Speckle.Sdk"></a> <a href="https://www.nuget.org/packages/Speckle.Objects/"><img alt="NuGet Version" src="https://img.shields.io/nuget/v/Speckle.Sdk?label=Speckle.Objects"></a> <a href="https://www.nuget.org/packages/Speckle.Automate.Sdk/"><img alt="NuGet Version" src="https://img.shields.io/nuget/v/Speckle.Sdk?label=Speckle.Automate.Sdk"></a>

Repo structure

This repo is the home of our Speckle .NET SDK.

• SDK
  • Speckle.Sdk: Send/Receive operations, Serialization, API wrappers, and more!.
  • Speckle.Sdk.Dependencies: Dependencies and code that shouldn't cause conflicts in Host Apps. This uses IL Repack to merge together and interalized only to be used by Speckle.
  • Speckle.Automate.Sdk: .NET SDK for Speckle Automate
• Speckle Objects
  • Speckle.Objects: The Speckle Objects classes used for conversions.
• Tests
  • Tests: Unit, serialization, integration, and performance tests.

Other repos

Make sure to also check and ⭐️ these other repositories:

• speckle-sharp-connectors: our csharp repo of next gen connectors.
• speckle-server: the speckle server.
• speckle-sketchup: Blender connector.
• speckle-sketchup: Sketchup connector.
• speckle-powerbi: PowerBi connector.
• and more connectors & tooling!

Documentation

Developer docs are a bit patchy. See our 📚 Speckle Docs website

Developing and Debugging

To build solutions in this repo, version 10.0.2xx of the .NET SDK is required.

It is recommended to use JetBrains Rider (version 2025.3 or greater) or Microsoft Visual Studio 2026 (version 18.4 or greater)

From there you can open the main Speckle.Sdk.slnx solution and build the project.

Formatting

We're using CSharpier to format our code. You can use Csharpier in a few ways:

• Install CSharpier and reformat from CLI

  dotnet tool restore
  dotnet csharpier format ./
  

• Install the CSharpier extension for Rider or Visual Studio<br/> For best DX, we recommend turning on CSharpier's reformat on save setting if you've installed it in your IDE.

Tests

There are several test projects. It is a requirement that all tests pass for PRs to be merged.

The Integration test projects require a local server to be running. You must have docker installed. Then you can run docker compose up from the root of the repo to start the required containers.

In CI, they will be run against both the public and private versions of the server. It is important that we remain compatible with both server versions.

Contributing

Before embarking on submitting a patch, please make sure you read:

Security and Licensing

Security

For any security vulnerabilities or concerns, please contact us directly at security[at]speckle.systems.

License

Unless otherwise described, the code in this repository is licensed under the Apache-2.0 License. Please note that some modules, extensions or code herein might be otherwise licensed. This is indicated either in the root of the containing folder under a different license file, or in the respective file's header. If you have any questions, don't hesitate to get in touch with us via .