Skip to content

Developer Documentation

๐Ÿ“ Location of Developer Documentation

Developer documentation for Kepler and related projects is maintained within each project's repository under the docs/developer/ directory.

๐Ÿ”— Kepler Developer Documentation

For comprehensive developer documentation including architecture, development workflows, testing strategies, and contribution guidelines, please visit:

๐Ÿš€ Kepler Developer Documentation

What You'll Find There

  • Architecture Overview - Service-oriented design patterns and component structure
  • Development Environment Setup - Docker Compose, local builds, and testing
  • Power Attribution Guide - Deep dive into energy measurement and attribution algorithms
  • Pre-commit Hooks - Code quality and automated checks setup
  • Release Workflow - How releases are created and managed
  • Testing Strategy - Unit tests, integration tests, and race detection
  • Service Interfaces - Understanding the service framework and lifecycle management
  • Configuration Management - YAML hierarchy and CLI flag systems

๐Ÿ› ๏ธ Quick Developer Setup

For immediate development setup, the key commands are:

# Clone and build
git clone https://github.com/sustainable-computing-io/kepler.git
cd kepler
make build

# Development with Docker Compose (includes Grafana + Prometheus)
cd compose/dev
docker-compose up -d

# Run tests
make test

# Local development
sudo ./bin/kepler --config hack/config.yaml

For other projects in the Kepler ecosystem, check their respective repositories:

๐Ÿค Contributing

Before contributing to Kepler, please review:

  1. Developer Documentation - Technical implementation details
  2. Contributing Guide - General contribution process
  3. Code of Conduct - Community guidelines

๐Ÿ’ฌ Developer Support


Developer documentation is actively maintained in the project repository to ensure it stays current with the codebase.

Copyright Contributors to the Kepler's project.

The Linux Foundationยฎ (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.