makora-ai/makora

makora-ai/makora

Description: Everyone's favourite kernel generation agent, now in your CLI!

Language: Python

License: Apache-2.0

Stars: 8

Forks: 0

Open issues: 0

Created: 2026-02-26T17:36:55Z

Pushed: 2026-03-30T20:54:39Z

Default branch: main

Fork: no

Archived: no

README:

Makora CLI

The Makora CLI is a command-line interface (CLI) for interacting with Makora Generate.

Use it as a standalone tool or with your favourite coding agent!

Installation and Setup

Prerequisites

• Python 3.10+
• pip

Install

pip install makora

or for editable mode (development), after cloning this repo:

pip install -e .

Verify install

makora --help

Login Before Using Protected Commands

Most commands require authentication first.

1. Create/copy an API token from: https://generate.makora.com/tokens

2. Login interactively:

makora login

or non-interactively:

makora login --token

3. Confirm login state:

makora info

To clear credentials:

makora logout

Subcommands

Below is the summary of available subcommands provided by the package. For a more comprehensive introduction and overview, please see: https://docs.makora.com.

> Note: also try consulting each subcommands --help!

| Subcommand | Login required | Purpose | |---|---|---| | login | No | Save API credentials for CLI use. | | logout | No | Remove saved credentials. | | info | No | Show version, env vars, and current login status. | | generate | Yes | Validate code and create a new optimization session. | | jobs | Yes | List your sessions/jobs. | | stop | Yes | Stop a running job/session. | | kernels | Yes | List kernels for a session or show kernel code. | | check | Yes | Validate a kernel/problem file without creating a full run. | | refcode | Yes | Show the original reference code for a session. | | profile | Yes | Profile optimized vs reference code on remote hardware. | | evaluate | Yes | Benchmark optimized vs reference code on remote hardware. | | expert-generate | Yes | Generate improved kernel code with additional tools. | | document-search | Yes | Search documents via the additional-tools document search API. | | install | Yes | Install the Makora plugin (currently claude). |