Skip to content
/ kb_sdk Public
forked from kbase/kb_sdk

Build and test new Apps for the KBase platorm

License

Notifications You must be signed in to change notification settings

ugswork/kb_sdk

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

alt text KBase SDK

The KBase SDK is a set of tools for developing KBase Apps that can be dynamically registered and run on the KBase platform. Apps are grouped into modules that include all code, dependencies, specification files, and documentation needed to define and run Apps in the KBase Narrative interface. By using Docker combined with the KBase App Catalog, you can build and run a new "Hello World!" App in KBase in minutes.

There are still some general restrictions on functionality that will gradually be lifted as the SDK and KBase platform are refined. The current restrictions are:

  • Runs completely on a standard KBase worker node (at least 2 cores and 22GB memory)
  • Operates only on supported KBase data types
  • Uses existing data visualization widgets
  • Does not require new uploaders/downloaders
  • Wrapper written in Python, Java, R, or Perl

If you have a tool you would like to register with KBase that cannot meet these requirements, please contact us to discuss possible solutions.

In order to register your Apps with KBase, you have to be an approved developer. To become approved, first create a standard KBase user account through http://kbase.us and apply for a developer account. Once you have submitted the forms, please contact us at http://kbase.us/contact-us with your username and we will help with the next steps.

Steps in Using SDK

  1. Install SDK Dependencies
  2. Install and Build SDK
  3. Create Module
  4. Edit Module and Method(s)
  5. Locally Test Module and Method(s)
  6. Register Module
  7. Test in KBase
  8. Complete Module Info
  9. Deploy

Additional Documentation


## Quick Install Guide

Below is a quick reference guide for standard installation. For more complete details and troubleshooting, see the Full Installation Guide.

For the adventurous, there is an experimental Dockerized installation that only requires Docker. It is known to work on at least Mac and Linux, but has not been extensively tested yet. For details, see Dockerized Installation

Installation Only

System Dependencies:

Get the SDK:

git clone https://github.com/kbase/kb_sdk

Pull dependencies and configure the SDK:

cd kb_sdk
make bin

Download the local KBase SDK base Docker image:

make sdkbase 

Add the kb-sdk tool to your PATH and enable command completion. From the kb_sdk directory:

# for bash
export PATH=$(pwd)/bin:$PATH
source src/sh/sdk-completion.sh

Test installation:

kb-sdk help

Build from source

Additional System Dependencies:

Follow basic instructions above. Instead of running make bin you can run make to compile the SDK:

cd kb_sdk
make

## Quick Start Guide

Initialize a new module populated with the ContigFilter example (module names need to be unique in KBase, so you should pick a different name):

kb-sdk init --example -l python -u [your_kbase_user_name] MyContigFilter

Enter your new module directory and do the initial build:

cd MyContigFilter
make

Edit the local test config file (test_local/test.cfg) with a KBase user account name and password:

test_user = TEST_USER_NAME
test_password = TEST_PASSWORD

Run tests:

cd test_local
kb-sdk test

This will build your Docker container, run the method implementation running in the Docker container that fetches example ContigSet data from the KBase CI database and generates output.

Inspect the Docker container by dropping into a bash console and poke around, from the test_local directory:

./run_bash.sh

When you make changes to the Narrative method specifications, you can validate them for syntax locally. From the base directory of your module:

kb-sdk validate

Add your repo to GitHub (or any other public git repository), from the MyContigFilter base directory:

cd MyContigFilter
git init
git add .
git commit -m 'initial commit'
# go to github and create a new repo that is not initialized
git remote add origin https://github.com/[GITHUB_USER_NAME]/[GITHUB_REPO_NAME].git
git push -u origin master

Now go to https://appdev.kbase.us/#appcatalog/register. Enter your public git repo url (e.g. https://github.com/[GITHUB_USER_NAME]/[GITHUB_REPO_NAME]) and submit. Wait for the registration to complete. Note that you must be an approved developer to register a new module.

Your method is now available in the AppDev environment in KBase. Go to https://appdev.kbase.us and start a new narrative. Click on the 'R' in the method panel list until it switches to 'D' for methods still in development. Find your new method by searching for your module, and run it to filter some contigs.

Your method will now also be visible in the App Catalog when displaying Apps in development: https://appdev.kbase.us/#appcatalog/browse/dev and https://narrative.kbase.us/#appcatalog/browse/dev. From your module page (e.g. https://narrative.kbase.us/#appcatalog/module/[MODULE_NAME]) you'll be able to register any update and manage release of your module to the production KBase environment for anyone to use.

Now, dive into Making your own Module.


## Example Modules

There are a number of modules that we continually update and modify to demonstrate best practices in code and documentation and present working examples of how to interact with the KBase API and data models.

  • MegaHit (Python) - assembles short metagenomic read data (Read Data -> Contigs)
  • Trimmomatic (Python) - filters/trims short read data (Read Data -> Read Data)
  • OrthoMCL (Python) - identifies orthologous groups of protein sequences from a set of genomes (Annotated Genomes / GenomeSet -> Pangenome)
  • ContigFilter (Python) - filters contigs based on length (ContigSet -> ContigSet)

## Need more?

Browse through the doc directory of this repo for the latest avaialble documentation. If you still have questions or comments, please create a GitHub issue or pull request, or contact us through http://kbase.us/contact-us

About

Build and test new Apps for the KBase platorm

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 87.1%
  • Python 5.4%
  • Perl 2.7%
  • HTML 2.5%
  • Shell 0.9%
  • JavaScript 0.6%
  • Other 0.8%