Hummingbird is a set of Grasshopper components that facilitate the creation of Revit native geometry. This process exports basic geometric properties and parameter data to CSV text files which is used to describe many aspects of the Revit BIM geometry. In Revit this data is easily imported using the Whitefeet Modelbuilder tool (included).

Translating Rhino primative geometry to Revit has been vastly simplified without the need for linking or reference objects. This allows for the downstream Revit model to be modified and adapted for the project duration.

The tool now supports importing Revit geometry into Rhino.  This makes a bi-directional workflow possible.


  • Bi-Directional Revit <--> Rhino support!  New component allows reading data output from Revit to create geometry in Rhino.
  • Support for Revit 2015 (as well as 2014).
  • Units!, Whitefeet ModelBuilder tool now includes the ability to specify metric or other custom units upon import.
  • No more Excel! Read and write using simple CSV text files.

Hummingbird for grasshopper includes the following components:

  • Adaptive Components
  • Floors
  • Grids
  • Levels
  • Walls
  • Beams
  • Columns (both structural & architectural)
  • Lines  (detail, model, area bound, room sep)
  • Lofts (place points, curve by points)
  • Rooms_Areas
  • MassFamily (Extrudes a closed polyline into a mass family)
  • Topo Surfaces
  • Family Instances (places any revit family by coordinate point)
  • Import (reads .CSV file and creates Rhino geometry)


To use this solution you must have the following software installed:

  • Windows 7 with .NET 3.5 and .NET 4.0.
  • Revit:  Revit 2014/2015 (for 2013 use the older version)
  • Rhino: Version 5.
  • Grasshopper: 0.9.0056

To install:

Run the installer which will install both the grasshopper component as well as the Whitefeet ModelBuilder addin.

For more examples and information:

- Tim & Mario

Support Email: 4FQ.Y4@LFPSY4ZK@
Plug-in rating:
Average: 4.6 (12 votes)
Title Release Notes
Hummingbird w/ Rhino Input
Added component for reading ModelBuilder .CSV files to create geometry in Rhino.  
Version: 2.2
Language: English
Hummingbird for Revit 2014-2015
This update supports both Revit 2014 and 2015. You will need the 64-bit version of Rhino 5 and Grasshopper 9.  
Version: 2.1
Language: English
Hummingbird 2
Major update! Includes installer for both rhino and revit addins, custom units are now supported, no more excel!, CSV text files are now the main transport format, Revit 2014 only  
Language: English
Hummingbird (old)
Previous version of the Hummingbird Component Set. Updated to work with Rhino 5.0, added new Level component - Allows for the creation of Revit Levels.  
Language: English


marioguttman's picture

I've posted a new version that includes a component for uploading Revit data to Rhino.  I also added a link to a website where I have posted some sample data.  Be sure to look at the revised Users Guide.  And tell me what is working or not working for you.

Hi Tim and Mario,


does Hummingbird run with Win8.1?



I'm using this with Grasshopper 9.0076, and I' getting index errors and "unable to write .csv files.

marioguttman's picture

Can you provide more specifics about what you are tring to do and what files you are using?  Try the "Proof Files - 2015" from the site.

I've installled Hummingbird for Revit 2014/2015.  When I tried using the Sample fiels in the Minimal Test File I get these message when I attempt to write a .csv file.


CSV writer version 2013-08-18

Unable to create or connect to .csv file.  Folder must exist and existing file must not be in use.  EstablishCSVlink() failed.

Any idea?

marioguttman's picture

Can you try downolading the Revit 2015 sample data from the site and testing the "Proof Files - 2015".  Although the Revit file in this set requires 2015 the Rhino-Grasshopper files are the same.

marioguttman's picture

The new version has been posted on this site.  It installs for both Revit 2014 and 2015 (even if you don't have them on your computer.)

There are some useful documentation and sample files at in the Hummingbird - Rhino to Revit Translation section. (You will need to create an account and agree to the license agreement but you can use Hummingbird without buying a WhiteFeet Tools license.)

This update exposed a number of issues that need to be fixed.  We are also working on a Revit --> Rhino upload option.  So stay tuned for another update.

And keep sending messages and posting stories about what you are doing.

marioguttman's picture

I've created a new version that includes ModelBuilder for both Revit 2014 and Revit 2015.  It requires Rhino 5.  Available from for now.  I'll try to get it up on this site as soon as possible.

Thanks Mario! I didn't think you were updating it anymore?

marioguttman's picture

Yeah, I got beaten up about abandoning it.  The best way to keep me working on it is to post stories about what you are doing with it.  Currently looking at a Revit-->Rhino tool for transfering geometry out of Revit and into Grasshopper.  Would you use that?  Mario

Hi Mario. Its good to have you back. Yeah a Revit > Rhino tool would be useful. Chameleon had one but it hasn't been updated in a LONG time and is no longer available for download. One of the limitations I found with it was that everything came in as meshes. There was a lot of rework required to make the geometry and data structure usable. If this could be streamlined it would be awesome. I'm now using more Dynamo to take things from Grasshopper to Revit. But there isn't much out there if you want to go the other way...

Hi Tim and Mario,

Is there any way to get a wall to come into revit on something other than the wall centerline? Can we get finish face exterior or finish face interior? I think the plugin is amazing, and I am hoping that you guys keep developing it because it could be even more powerful than it already is.


marioguttman's picture

I have reactivated the site.  You can download the 2015 version of the WhiteFeet Tools and use the ModelBuilder to do the Revit side of the translation. You can use the current version of Hummingbird to do the Rhino side.  Sorry, I've been slow to get a 2015 Hummingbird package out.  Mario


Will a new Hummingbird for revit 2015 going to be released soon?

Thank you,



Does Humming bird support the latest version of grasshopper? 

And the version for Revit 2015 is coming soon yet?

I tried to transfer models from Rhino to Revit 2014. All the columns and axises are stacked together. The grasshopper version I am using is 0.9.0075.

Does anyone have the same situation?

It would be great if someone could pass me basic exampls I could start with. my e-mail address is 




I'm trying to export multiple columns with multiple types. However, regardless of if I fatten or graft the list of types, it only writes one type to the *csv. Is it possible to export multiple types?

tjmeador's picture

You'll have to use multiple copies of the column component. One for each type. 

wlqq_2004's picture

Can I use the hummingbird(Model Builder) to add doors and windows components in revit file?I have Succeeded in palcing a desk,but I don't konw how to add a door。Please halp me,thanks~

Is the whitefeet website down?

marioguttman's picture

I am no longer running the WhiteFeet Tools website.

Hi Mario. Is someone else going to take over? What is the future of Hummingbird without the WhiteFeet plug-in?

michaelfrederick's picture

Hi.  When attempting to process a .cvs file in Revit 2014 is anyone else getting the error:

Error writing.ini file in UtilitySettings.WriteIniFile.System message:Access to the path ‘C:/ModelBuilder2014.ini’ is denied

local install of Revit 2014 running on a borrowed network licence

local install of Hummingbird 2.msi downloaded from this site 

no errors when installing Hummingbird2 only the one error when in Revit.  

any idea?

much thanks!


I can help ya with that one I think.. Save your revit project first.

If I understand correctly, it's trying to write to your C:/ and (presumably) you don't have admin rights. Was doign it for me as well but as soon as I saved the revit project, Hummingbird automatically wrote the ini file (ModelBuilder.ini) to the same directory as the revit file. Basically it stores the sessions hummingbird settings.

ogcsmysterio's picture

Hi Mario, I have recently downloaded hummingbird but I've got some trouble, I do my definition but I don't know why always it give me an empty file. I don't know where's the mistake, do you have some guide or tutorial? Thank you very much.

ogcsmysterio's picture

Hi, a newer version for Revit 2015 will be avaible soon? I have update my 2014 version but sadly I can't use Hummingbird anymore, and neither recover my 2014 Revit. Thank you,


Hey There, I am 2015 Revit. Do you have any anything in the work to play nice with 2015? 

Thanks, I know it's a lot of work to keep pushing out releases.



marioguttman's picture

akragness:  We do not have a 2015 package for Hummingbird but I have posted a 2015 version of the WhiteFeet Tools for Revit at You can use the 2014 version of Hummingbird to get the Rhino-Grasshopper components and then use the Model Builder in the 2015 version of the WhiteFeet Tools in Revit.


I was wondering if it is pooisble to feed multiple types into a hummingbird node like you can with the parameters ?

I notice when you export multiple floors from revit to Whitefeet it adds a line before each new type and set's the floor type.

I can't manage to get the same when exporting from Grasshopper/hummingbird, it wants to only set the type once.

I would like to be able to feed in multiple floor curves with corresponding mutliple floor types. is this something that can be done




Gary M



marioguttman's picture

Gary, The .CSV format and the Revit ModelBuilder addin can support that.  Unfortunately, the current Grasshopper plugin does not.  You could workaround by having a separate component for each floor.  Maybe someone who is better at Grasshopper than I am can suggest a better solution.  I'll take your request as a suggestion for the future.  Mario

Hi Mario

Thanks for gettting back to me

I have manage to fudge a work around for the moment

I am reading the CSV file back into GH and automating a line to apply the relevant thickness to each floor and then just stream out the results.

I have it working for Beams and other elements too it's working great

It means I can just add a name to curves in rhino or grasshopper and Hunmmingbird can just import them all onto the correct sizes.

Thanks for your help

Gary M

I am using Rhino 5.0 and the latest Hummingbird Build.  Whenever I try to make  a Mass Family I get the error:

Unable to create FamilyInstance


I am using the Sample data from whitefeet : SampleMassFamilies.csv


Please see image from flickr



marioguttman's picture

ancientholiday, I checked and that file does not run properly for me either.  A number of the files in that folder seem to have problems.  Sorry, sample data is due for a cleanup, but I keep putting it off.  Try the other two folders in the .ZIP file.  Mario

Hello and thank you very much Mario. It works!

I have been working with floors and walls and they import into Revit really well. But I am having some trouble with the component LoftForms. I am trying to import into Revit some double curved surfaces from GH but it does not work. Also, in the GH LoftForms component there is no 'Type' input, so I wonder if it is not possible to apply a Revit material to the surfaces...

Could you please explain how the loft works? I have checked the Sample included in the installation folder but it does not work...

Thank you so much!


I have successfully added walls from the tutorial files; however, when I section my floors they show up as errors in REvit. The CSV file looks very similar to the one in the tutorial files. Anyway to solve this?


Secondly, I have a custom mass that I have contoured to get the floor curves. There are three index errors and failure to write a CSV file. Not sure why it works in the tutorial version. I have tried grafting the input from the curves as well. 

Do I have to have the gridlines specifying the floor heights before the floors are made?

Hi, I have download and installed version 2.0 in my computer (Windows 7, 64-bit) and when I open Revit 2014 and click in ModelBuilder there are some errors happening:

1st Error: The path is not of a legal form

2nd Error: Error in UtilitySettings.Refresh.RevitValues()

If I Accept and Import the .cvs file exported from Rhino 5 and click Process:

3rd Error: Error writing.ini file in UtilitySettings.WriteIniFile.System message:Access to the path ‘C:/ModelBuilder2014.ini’ is denied.

4th Error: Unable to connect to file with path. Stopping process.

Which could be the problem? 

Thank you very much in advance.


marioguttman's picture

lusamu:  Please get the latest version, documentation, and sample data from here:  If the problem persists provide more detail about your working environment:  are you working on a local machine?  What is the path that is failing? Screenshots are helpful.

I am having the same problems with New Hummingbird installation





On the Revit Side, I no longer have any issues, however from Grasshopper, Hummingbird components do not write csv.

Whenever I activate hummingbird component in GH, I get a message saying that it cannot write to .csv.

I never had this problem with writing to excel.

Also, how come Hummingbird can not modify components in Revit that it has placed.  It would be convienient to move or modify components that it placed on a previous run so as not to have to re-tag components.


I have installed hummingbird with the new installation sequence.

Now I get message: Unable to connect to .csv file. Folder must exist and existing file must not be in use.


How can i change  hummingbird to connect to excel file instaed? I never had problem to connect to excel file.

I am having difficulty using excel to update the floors in my revit model from grasshopper. I use the lunchbox component to read the file then intersect brep etc.. and it doesn't update the second excel file that revit needs from the hummingbird component. if anyone could take a look or give me a clue to how to accomplish this, then that would be great. maybe because the 'tab; component changed to 'file'?

thanks in advance


marioguttman's picture

brobes05:  I'm not quite sure what you are doing.  The current version of Hummingbird does not use Excel; it reads and writes a .CSV file.  Get the latest version and documentation from here and give some more specifics about the steps you are taking. 

Hi, I have the latest version of the plugin. I can't figure out how to upload a gh file or an image. I have set up the floor GH flow properly however the Hummingbird Floor component will not recognized any data from my section cuts and outputs failures at indexes etc... i cannot figure out how to make this work properly. 


Hi, I installed newest version of hummingbird to my computer [windows8, most recent rhino5+grasshopper, revit 2014]. 

When I try to install hummingbird the dll. error shows up, "There is a problem with this Windows Installer package. A DLL required for this install to complete could not be run. Contact your support personnel or package vendor."

I am really exicted to try out this plug-in, but I just cant!


JooYoung Ham 

marioguttman's picture

hiy7772: We have confirmed that the installer works with Windows 8.  Can you give any more detail about the error message?  Is your Windows configured to US English?  Can you try on another computer?  I'll try to help but don't have any suggestions yet.

Hi, I am experiencing the same problem, what can I do? (also GREVIT msi returns the same DLL error). Thanks.

Win 8.1 64x US

Revit 2014

GH 0.9.0076

Rhino 5

Hi Tim and Mario:

my computer is 32-bit Windows platforms,

I dont know  if there is a x32 version for  Hummingbird 2 ?

i even can not open installation file

thank you:)

marioguttman's picture

sunrise1028: I don't test against 32-bit so I can't say for sure but I don't expect any of it to work.  Sorry.  Time to upgrade.

wlqq_2004's picture

Hi Peirramo, I want to know how to add an arc-based grid from CSV. When I read  the  CSV file in revit,the error is that:

1.One or more errors encountered:

Error in ConvertHbCurve: The vectors end1 and pointOnArc are coincident.
Parameter name: end1.
Inner Error Severity: 
Inner Error Message: 
RowId: 0
ElementId: 268635
Action: Add
Object: Grid
Value01: 40807.37485017, 27341.81432411, 0.00000000
Value02: 17564.64085911, 34487.70888917, 0.00000000
Value03: 30345.42534135, 34685.88249049, 0.00000000

marioguttman's picture

wlqq:  When the ModelBuilder gets three values for a grid it attempts to create an arc.  I'm not sure why you are getting this message since the points don't seem to be the same.  Try editing the .csv file an putting simpler values in.  The order is start, end, middle (I think) I'm a little suspicious of the values since Revit interprets them in feet.  You can adjsut this with the units setting in the ModelBuilder.  These values seem too big and that may be confusing Revit.  If you are still having trouble please post the .csv file.  Mario

wlqq_2004's picture

OK,I have post the file to your E-mail(,it contains the file of rvt,CSV,rhino and grasshopper,please check it.Thank you very much!

Protected Collaborative Environments Wildcard SSL Certificates
© 2015McNeel Europe. User-submitted content and trademarks property of their respective owners.