Generating matplotlib charts from the terminal

Turn numbers into line, bar, pie, scatter, histogram, and pareto PNG charts using natural language or Arka CLI commands, powered by matplotlib.

Turn numbers into PNG charts. Seven chart kinds supported via offline NL parsing — no LLM required for most requests.

pip install "arka-agent[charts]"

Chart types

Kind	CLI	NL example
line	arka chart line AAPL TSLA --range 1y	compare Apple and Tesla stock last year
bar	arka chart bar --data "A:1,B:2"	phone sales Apple 230 Samsung 210
pie	arka chart pie --data "A:40,B:30"	pie chart traffic organic 400 direct 300
scatter	arka chart scatter --data "100:200,120:190"	scatter ad spend vs revenue 100 200 120 190
histogram	arka chart histogram --data "12,15,18,22"	histogram response times 12 15 18 22
pareto	arka chart pareto --data "A:45,B:28"	pareto defects Scratches 45 Dents 28

Direct CLI

arka chart line AAPL TSLA --range 1y
arka chart bar --data "Apple:230,Samsung:210,Xiaomi:140" --title "Phone sales"
arka chart pie --data "Organic:400,Direct:300,Referral:300" --title "Traffic"

Chart defaults

Store reusable data in ~/.config/arka/charts.yaml:

defaults:
  scatter:
    data: "100:200,120:190,170:280"
    xlabel: "Ad Spend"
    ylabel: "Revenue"
  line:
    tickers: [AAPL, TSLA]
    range: 1y

Charts save to ~/Pictures/arka-generated/ and open automatically on macOS/Linux.

# CHART_OUTPUT_DIR=~/Pictures/arka-generated
# CHARTS_CONFIG=              # override defaults file path