New Ticket

TICKET_CREATE privileges are required to perform this operation. You don't have the required permissions

Login Close

Version 16 (modified by jdreimann, 6 years ago) (diff)

Added emphasis to the text encouraging people to join the mailing list.

Getting Involved with Apache Bloodhound

You are probably here because you are interested in getting involved in this project but you do not know where to start. Here are some suggestions, starting with tickets we think are suitable for those new to Bloodhound:

Results (1 - 5 of 25)

1 2 3 4 5
Ticket Summary Keywords Type Status Priority Product
#550 Bootstrap template for error.html starter bootstrap enhancement new major BHD
#276 Make error notice more prominent on failed login starter enhancement closed minor BHD
#587 Change information box should span width of Wiki Edit page when in side-by-side edit mode wiki edit starter enhancement new major BHD
#505 Query suggestions bep-0004 bep-0004-stable starter defect new major BHD
#724 Sub-query links in ticket group stats widget milestone product dashboard, starter enhancement new trivial BHD
1 2 3 4 5


The most important first step to getting involved is joining in with the discussion. You should join the mailing list - it is always great to hear from people who are interested in the project and discussions there are the main way of influencing the project. To subscribe, send a message to'. There's also a public archive of the mailing list.

Once you have signed up, you will be able to provide feedback, discuss ideas for improvement and tell us that you would like to help.

Getting the Source Code

Apache Bloodhound is written in Python and so, if you have already successfully installed Bloodhound, you will probably have all that you need to develop it too.

BloodhoundInstall and BloodhoundDetailedInstallation both provide information about installing but, if you already have Python, python-setuptools, python-pip and python-virtualenv, installation can be achieved as follows:

svn co bloodhound
cd bloodhound/installer
virtualenv bloodhound
source bloodhound/bin/activate
pip install -r requirements-dev.txt
python --database-type=sqlite --admin-user=admin --admin-password=adminpasswd

after which you can run the standalone server:

tracd -r --port=8000 bloodhound/environments/main

With this method of installation, the Bloodhound and Trac code is run direct from the checked out code. Any source code for external dependencies and plugins meanwhile will be found in ../installer/bloodhound/src/.

You should find that when you make changes to the associated source code, when using the -r option on tracd, the server will reload and the edited code will be run instead of the original. In order to get templates to reload after modifications are made, you can edit bloodhound/environments/main/conf/trac.ini and add the following line to the [trac] section:

auto_reload = true

Contributing Code

We are more than happy to see people contributing code to the Apache Bloodhound project. These are usually expected to take the form of a patch that can be tested and commented on. For now, such patches should be posted to the mailing list.

We do attempt to stick to the coding standards that are listed in BloodhoundDevGuide but we prefer to see people discussing code rather than holding back because it is not yet perfect.

The BloodhoundDevGuide should also be a good resource for those who want to get more involved in the project.

Contributing Designs

This project has a strong focus on usability. How to use the application should be obvious, even for novice users. We believe that the application can go a long way towards helping people become intermediate users quickly too.

UI Designs and usability questions are regularly discussed on the dev mailing list - please do join in with any constructive comments. We generally expect screens to looks as in our default Ui/Layout.

Mockups can be found attached to the relevant tickets and wiki pages.

After the mockups are discussed, we frequently create HTML templates to further improve the clarity of the suggestions and to allow for usability testing to be carried out. We have adopted the CSS and some javascript functionality from the Bootstrap project.