algo-host

Q: How do I install algo-host?

Run npx skills add https://github.com/marketcalls/openalgo-execution-skills --skill algo-host in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/algo-host/ (personal) or .claude/skills/algo-host/ (project).

by marketcallsDevOps & Cloud

Validate a generated strategy and produce an upload guide for OpenAlgo's /python self-hosted strategy page. Confirms env-var reads, SIGTERM, stdout-only logging.

Installs: 41
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/marketcalls/openalgo-execution-skills --skill algo-host

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads algo-host automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Prepare a strategy for upload to OpenAlgo's /python strategy host.

Arguments

$0 = strategy name (e.g. ema_crossover_SBIN) OR full path to a .py file
Special: --list lists deployable strategies in strategies/ and their validation status

If $0 is a folder name, the file is strategies/<name>/strategy.py. If it's already a path, use as-is.

Instructions

Read algo-expert/rules/self-hosted-strategies.md.
Read the strategy file.
Validate these criteria (each can be inferred via grep):

Check	What to look for
SIGTERM handler	`signal.signal(signal.SIGTERM, ...)` present
SIGINT handler	`signal.signal(signal.SIGINT, ...)` present
stop_event used	`threading.Event()` and `stop_event.set()`
HOST_SERVER priority	`os.getenv("HOST_SERVER") or os.getenv("OPENALGO_HOST",` pattern
Reads STRATEGY_EXCHANGE	`os.getenv("OPENALGO_STRATEGY_EXCHANGE",` pattern
stdout logging	`stream=sys.stdout` in `basicConfig`; no `FileHandler` calls
Strategy entry guard	`if __name__ == "__main__":`
Mode dispatcher	`--mode` argparse with `default=os.getenv("MODE", "live")`
No hardcoded local paths	`/home/`, `C:\\Users`, `/Users/` not present
Env tag for STRATEGY_NAME	`os.getenv("STRATEGY_NAME",` pattern

Print a validation report:

Validation: strategies/ema_crossover_SBIN/strategy.py
  [PASS]  SIGTERM handler installed (line 327)
  [PASS]  HOST_SERVER priority correct
  [PASS]  Reads OPENALGO_STRATEGY_EXCHANGE
  [PASS]  stdout-only logging
  [PASS]  Mode dispatcher honors env MODE
  [WARN]  No state.db persistence detected (optional)
  [PASS]  No hardcoded local paths
  ALL REQUIRED CHECKS PASSED

Generate HOST_UPLOAD.md in the same folder with the exact form values to enter at http://localhost:5000/python:

# Upload Guide: <strategy_name>

## On http://localhost:5000/python

### Step 1: Click "Add Strategy"

| Form field | Value |
|---|---|
| Name | <strategy_name> |
| File | <full path to strategy.py> |
| Exchange | <SYMBOL's exchange, e.g. NSE> |

### Step 2: Parameters (key=value, one per row)

| Key | Value | Purpose |
|---|---|---|
| MODE | live | live execution (sandbox/real per UI analyzer toggle) |
| SYMBOL | <SYMBOL> | trading symbol |
| INTERVAL | <INTERVAL> | bar interval |
| LOG_LEVEL | INFO | logging verbosity |

### Step 3: Schedule

| Field | Value |
|---|---|
| Start time | 09:15 IST |
| Stop time | 15:30 IST (or leave empty for indefinite) |
| Days | Mon, Tue, Wed, Thu, Fri (weekdays for NSE) |

For MCX strategies use `EXCHANGE=MCX` and start time `17:00`.
For CRYPTO use `EXCHANGE=CRYPTO` and check all 7 days.

### Step 4: Click Upload, then Start

The host launches the strategy in a subprocess. Logs go to `openalgo/logs/strategies/<id>_<timestamp>.log`.

To stop the strategy gracefully, click Stop in the UI - the host sends SIGTERM and waits up to 15s for clean shutdown.

## Notes

- Live vs sandbox is decided by OpenAlgo UI's analyzer toggle, not by this strategy
- Re-upload anytime; the host preserves STRATEGY_ID
- The exchange you pick drives the calendar gating; intersect with start-stop

If --list, list strategies/ subfolders, validate each, print a summary table.

When validation FAILs

Print the specific lines that need fixing:

[FAIL] HOST_SERVER priority: line 38 reads OPENALGO_HOST first.
       Change:
           API_HOST = os.getenv("OPENALGO_HOST", "http://127.0.0.1:5000")
       To:
           API_HOST = os.getenv("HOST_SERVER") or os.getenv("OPENALGO_HOST", "http://127.0.0.1:5000")

Offer to make the fix automatically (use Edit tool).

Reset state

If the user asks to reset a strategy's persistent state before re-upload, suggest:

rm strategies/<name>/state.db

Or, if no state.db exists, no action needed.

Avoid

Do not auto-upload via API - the /python page is a UI form, not an API endpoint
Do not modify the strategy's logic, only the host-compatibility plumbing
Do not use icons/emojis

FAQ

What does the algo-host skill do?

Validate a generated strategy and produce an upload guide for OpenAlgo's /python self-hosted strategy page. Confirms env-var reads, SIGTERM, stdout-only logging.

How do I install algo-host?

Run npx skills add https://github.com/marketcalls/openalgo-execution-skills --skill algo-host in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/algo-host/ (personal) or .claude/skills/algo-host/ (project).

Which AI agents can use algo-host?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is algo-host safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains algo-host?

It is published by marketcalls in marketcalls/openalgo-execution-skills. It has 41 recorded installs.