Repository files navigation

Kevin-CI is a self-hosted continuous integration service.

With Kevin you havemaximum-speed builds, spectacular GitHub integration and the best™ CI experience ever.

Kevin-CI supportsQEMU,LXD andPodman.

Kevin is a self-hostable CI daemon to buildpull requests inside temporary containers.

It was mainly developed foropenage,but you can use it forany project!

Kevin can create doc files, bundle software, run tests, make screenshots,end world hunger, calculate the last digits of pi: all in a custom container.

Requires:

• Python >=3.11
• aiohttp
• and some container/vm to run jobs in

• Kevin: Receives triggers and launches the builds
• Justin: Provides temporary containers to Kevin
• Chantal: Run inside the container to execute the Job
• Mandy: Webinterface to view live-results

• kevin is notified by a GitHub webhook
• It spawns a temporary Container/VM from a template to run the job
• The repo is cloned and the build/test steps inkevinfile are executed
• Progress can be viewed live via Web-UI, GitHub,curl or websocket API
• Results are instantly reported to GitHub

• Makefile-likecontrol file (kevinfile)

  • Directly specify command dependencies of your build
  • Report the step results and timing back to github

• Live-view of build console output

  • See what the machine builds in real-time
  • Store and download resulting files (e.g. releases)

• GitHub pull requests

  • A build is triggered for each new and updated pull request
  • When you push to a currently-in-build branch,the previous build is canceled

• File output

  • Let your project generate files and folders
  • They're saved to the static web folder
  • Use it to generate documentation, releases, ...

• Container management

  • Jobs are built in temporary throwaway VMs
  • Easily change and update the base images

How?Lurk into our setup guide.

• Hostingservices:
  • GitHub,
  • GitLab,
  • ...
• Supported container/VM tools
  • qemu
  • podman
  • lxd
  • docker
  • libvirt
  • xen
  • nspawn
  • ...

If you have questions, suggestions, encounter any problem,please join ourMatrix channel and ask!

Of course, createissuesandpull requests.

Released under theGNU Affero General Public License version 3 or later,seeCOPYING andLICENSE for details.