---
title: "Quickstart"
canonical: "https://help.biobam.com/space/BCD/2258829331/Quickstart"
format: markdown
---
# Before We Start

This section provides several usage examples for Blast2GO CLI. Please read the Installation chapter carefully and configure the GO Mapping database in your properties file before you continue.

Important things to consider:

- If you are using MS-Windows, all commands must be changed accordingly. Please replace **./blast2go_cli.run** with **blast2go_cli.exe**
- A properties file is always necessary, create it with:
- GO Annotation, Enzyme Code Mapping, Statistics, GO Slim and various import and export functions make use of the obo file (-useobo). Blast2GO CLI comes with a built-in obo file, however, we recommend downloading the latest version.
  The obo file version should match the GO Mapping database version. [http://resources.biobam.com/b2g_res/obo_files/index.html](http://resources.biobam.com/b2g_res/obo_files/index.html)
  The latest version can always be found here: [http://resources.biobam.com/b2g_res/obo_files/go_latest.obo.gz](http://resources.biobam.com/b2g_res/obo_files/index.html)  
Just provide this file additionally when executing a command:  
**./blast2go_cli.run -useobo go_latest.obo.gz -properties cli.prop -annotation ...**
- Make sure to have a working MongoDB server, with the GO Mapping database dump imported (see Installation chapter).

# Examples

1. Load a DNA fasta file, add the corresponding BLAST results and perform GO Mapping and Annotation. Furthermore, we want to save the .box file and the PDF report into the current directory.
  
2. This example requires a local Swissprot Database installation. Therefore, simply download and extract the file from: [ftp.ncbi.nlm.nih.gov/blast/db/swissprot.tar.gz](http://ftp.ncbi.nlm.nih.gov/blast/db/swissprot.tar.gz). Load nucleotide sequences, run local BLAST against the Swissprot database, GO Mapping and Annotation. We also create various statistics. Finally, the whole project will be saved in .box format with the chosen name prefix together with the log file. The LocalBlastAlgoParameters have to be configured:
  
  Command-line:
  
3. Load example_1.box from the first example and run Cloud-InterProScan (online). We will save the project, as well as the InterProScan results (default configuration):
  
4. Convert sequences to proteins and save them into a fasta file.
  
5. Load a Blast2GO project file, apply plants GO Slim, and save the results as .box, which will be saved with the default name prefix “b2g_project” into the current directory.
  
6. To run this example, we need the results from example 4. Run CloudBlast against Viridiplantae taxonomy (33090), GO Mapping, Annotation on the protein sequences and save the results as .box and customized annotation format. Please configure the following properties sections:
  
  
  Command-line:
  
7. Load a protein fasta file, add the corresponding BLAST results and execute GO Mapping and Annotation. All files (.box, .pdf, .annot and .txt) will be saved with the name prefix "example_7" in the "working dir" in the current directory. Additionally, the data distribution pie chart and enzyme statistics will also be saved in the “work dir” folder.
  Make sure that the export annotation format is annot.
  Command-line:
  
8. Load a fasta file, a BLAST result file, and InterProScan 5.0 files, perform GO mapping, annotation. Then create all the statistical charts. As a result, we want to obtain the .box and the PDF report, which will be saved with the default name prefix “b2g_project” into the current directory.
  Command-line:
  
9. Load an example data-set and export user-defined columns for each sequence. Please configure the following properties section:
  
  Command-line: