Kyso
Kyso.ioAbout Us
Search…
Getting started with Kyso
Getting started
Installation Options
Organizations & Teams
Publishing & Sharing
Kyso Command Line Tool
Kyso's Git Integration
Publishing Books & Websites
Creating Reports In-App
Configuring Report Metadata
Meta Reports
Reporting FAQ
Search and Discovery
How to Search
COLLABORATION
General Discussion
Report Collaboration
Settings & Administration
Permissions System
Managing Access
Resources
R Users & R Markdown
Migrating from Knowledge Repo
Writing a good data-science report
Introduction to Git
Installing Jupyter with Anaconda
Python Projects Workflow
Using SQL in Jupyterlab
Reproducibility with Docker
Team engagement
Powered By GitBook
Migrating from Knowledge Repo
A lot of our customers are users of Airbnb's KR when they come to us. In fact, this was such a common occurrence that we built an integration for it!

Importing your Knowledge Repo to Kyso

We've made it super simple to transition from your current data science workflow using Airbnb's knowledge repo to Kyso through our Github integration. You can even continue using the knowledge repo if you like and use Kyso to present and collaborate on your posts among your team. You can also create many Kyso posts from one Github repo as outlined in the Github integration documentation page.
Click on the New button in the navigation bar at the top and select Github Import.
Connect your Github account. On the next Page you will see a list of all your Github repositories. Your team's knowledge repo will also show up here just like any other repository on Github. Select it to connect. You can then view it on Kyso. You will see that we create a main post of the knowledge repo itself.

Troubleshooting

Important: We identify the knowledge repo by the existence of a.knowledge_repo_config.yml file in the knowledge repo itself, so it is important that you do not delete this file. We then read in the knowledge.md file as the main file to render on the main post. You can browse through the files and select different files to render.
Each .kp directory within the knowledge repo is published to Kyso as a separate post. Again, the knowledge.md file created from the source file will rendered as the main file on Kyso, and all other files within the specific .kp folder are attached. Unlike when connecting a regular Github repo, there is no need to specify a main file to render in a kyso.json file.
Important: Note also that if you delete the main knowledge repository then all the child reports synced to Kyso (i.e. the .kp folders) will be deleted too.

'Verification Error'

If you get a 'verification error' go to your repository on Github and navigate to the Settings > Webhooks page and if you see a webhook that points to 'api.kyso.io' simply delete it and then re import your repository to Kyso.
Resources - Previous
R Users & R Markdown
Next - Resources
Writing a good data-science report
Last modified 2mo ago
Copy link
Outline
Importing your Knowledge Repo to Kyso
Troubleshooting
'Verification Error'