Announcing the Naiad source code release
Update: we have a new release of Naiad on GitHub which supersedes the release discussed in this post, which is left intact for historical purposes.
We’re pleased to announce that the source code of Naiad is now available as a download from the Naiad project page.
Naiad is currently a research prototype, and its source code is in a constant state of flux. Nonetheless, we’ve tried to make it really easy for interested people to grab the source, compile it, and try out some of the example programs (and even write their own!). In this post, we’ve reproduced some of the getting-started instructions from the Naiad readme, and we’ll update this page first if we discover any issues with those instructions.
First, download the ZIP archive via the Naiad project page. Naiad is distributed as a Visual Studio 2010 solution, comprising two projects:
- “Naiad”, which contains the core Naiad system and support libraries,
and builds Naiad.dll. If you create your own project that uses
Naiad, you must add a reference to Naiad.dll.
- “NaiadExamples”, which contains several example applications and
These projects can be built and executed using any of the following implementations of the .NET framework:
- Microsoft .NET Framework 4.0
- Microsoft .NET Framework 4.5
- Mono 2.10.8
To build Naiad, follow the steps below that correspond to your setup.
Building using Visual Studio
- Open the Naiad.sln file in this directory using Visual Studio.
- On the menu bar, click Build > Build Solution, or press F6.
Building using MSBuild (on Windows, without Visual Studio)
- Ensure that MSBuild is installed on your local machine*. You can
get MSBuild by installing the Microsoft .NET Framwork, version
4.0 or 4.5. Typically, the file MSBuild.exe can be found in the
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\MSBuild.exeHowever, this path may differ, depending on your local
- Open a command prompt, and change to the directory containing the
- At the command prompt, run MSBuild.exe.
*Or try Naiad on Azure – at time of release there’s a free trial!
Building using Mono
- Open a terminal, and change to the directory containing the
- At the terminal, run xbuild from that directory.
Getting started with the example programs
As part of this source distribution, the NaiadExamples project
demonstrates how to write simple applications using Naiad. After
building the Naiad solution, you will find the executable
NaiadExamples.exe in the
NaiadExamples.exe uses command-line arguments to select an example,
and it is recommended that you run it from a command prompt or
terminal. For example, to run the word count example, follow these
- Open a command prompt or terminal, and change to the
- (On Windows) At the command prompt, type
- (On Linux or Mac OS) At the terminal, type
mono NaiadExamples.exe wordcount“.
- To discover other examples and options, run NaiadExamples.exe with the
If you have any trouble with these instructions, leave a comment below, or send us an email at naiadquestions at microsoft dot com.