Getting started with speckle can be approached from several directions: either as an end user, where you just want to send data and geometry around, as a developer wanting to build on top of speckle, or as a maintainer deploying a server for your company or group.
In order to use speckle, you will need to have some authoring software installed on your computer. We currently have integrations for Grasshopper, Dynamo, Rhino, and a WIP Revit client - either of those should do. It also helps to have a friend next to you, as it's much more fun to send data to each other rather than play ping-pong alone!
You will need to download and run the
SpeckleInstaller.exe file from the link above. This will install the latest release of the clients and once it is succesful, you should be able to open the speckle plugins the software you've installed it for.
Next, check out the guides on the left hand side - Grasshopper, Dyanamo, Revit, Rhino, etc. - as they will walk you through some of the basic steps of using Speckle. We haven't yet finalised writing the docs, so please bear with us!
Deploying a Server
The speckle server, in a nutshell, is a stateless nodejs application that can run on pretty much anywhere. Its dependencies are a small tiny redis instance to coordinate messaging (real time updates), and a mongo database to store information.
Deploying a speckle server is easy, but not for the faint-hearted, as hosting one entails a certain amount of risk. There are some guidelines in the github repository's readme, as well as a set of community-maintained instructions on the forum.
If you just want to test speckle, to begin with you can just use Hestia, the free server maintained by Dimitrie. To do so, just use
https://hestia.speckle.works/api as a server url input when promted by the clients, or just head over there now and register a new account.
Location: Hestia, the test server, is currently hosted by Digital Ocean in a data center in Frankfurt. For those of you far away - on the other side of the planet - this introduces some potentially quite high latency (upwards of 200ms). Furthermore, please be aware since data resides on European soil, European (and German) laws apply.
Developing and Extending
You can do quite a bit on top of speckle, and there's quite a few pieces that make speckle up. You can see most of them on the github organisation page. While we finesse the documentation, please have a look at the developers section!