Skip to content

repl

The REPL (Read-Eval-Print Loop) gives you an interactive session with tab completion, session state, and automatic server management. It’s the fastest way to explore a database interactively.

Terminal window
volca --config volca.toml repl

The REPL connects to a running VoLCA server. If no server is running, it starts one automatically.

volca[ecoinvent]>

The prompt shows the currently active database. Switch databases with use.

CommandDescription
activity UUIDGet activity info
inventory UUIDLife cycle inventory
impacts UUID --method M_UUIDImpact assessment (LCIA) scores
flow FLOW_ID [activities]Flow info
flow-mapping METHOD_UUIDFlow mapping coverage
CommandDescription
activities [--name X] [--geo X] [--product X]Search activities
flows [--query X]Search flows
CommandDescription
database [list|upload|delete]Manage databases
method [list|upload|delete]Manage method collections
methodsList loaded methods
synonymsList synonym sources
unitsList unit definitions
CommandDescription
use <db-name>Switch the active database
:format json|pretty|tableChange output format
:server startStart the server
:server stopStop the server
:server statusCheck server status
:helpShow help
:quit or Ctrl+DExit (stops the server)
  • Use Tab for command and flag completion.
  • Set :format json to get machine-readable output for piping.
  • The REPL activates a 10-second idle timeout on exit — the server stops shortly after you quit.
  • Output from each command is buffered and printed in full, then a new prompt appears.