Skip to main content

MyLab

Python Linux CLI Codex

MyLab 是一个专为科研实验设计的基于Codex的Agent框架。

我们希望 AI 能够在一步步的试错中不断探索,从一次次的先前实验中学习到经验;同时,我们也能从 AI 的一次次试错中找到真正的重点,帮助 AI 完成任务。

How It Works

我们把每一次的实验,变成一个Trial:

  • MyLab 不只执行一次命令,而是围绕同一个目标持续实验、沉淀总结,再进入下一轮试错
  • 每一轮都会将关键信息沉淀为一个Trial,包括 trial 定义、总结、结果、执行脚本和结构化日志,能让经验一直留存下来
  • 会持续积累“实验怎么跑、哪些方法有效、哪些坑已经踩过”,后续的MyLab会根据当前的目标,从所有历史 Trial 中“选择性地”提取最相关的经验
  • 人可以从这些 Trial 中快速看到 MyLab 到底试了什么、为什么失败、下一个优化方向到哪里,保留有价值的 Trial 作为基石,删除无用的 Trial 以剔除噪音,或者直接在 Trial 文件中写下你的点评

Quick Start

Prerequisites

  • Codex 安装并且登录
  • 科研实验仓库使用Git管理

Install

pip install mylab

Publish to PyPI

GitHub Actions 提供了基于 tag/release 的 PyPI 发布流程,见 .github/workflows/publish.yml。

发布前需要在 PyPI 项目里把这个 GitHub 仓库配置为 Trusted Publisher,然后创建一个 GitHub Release;工作流会自动构建并发布当前版本。

Start a Run

# 创建并启动一个新的 run
mylab start --repo /path/to/repo --goal "reproduce table 1" --mode unlimit
# 给 run 指定名字
mylab start --repo /path/to/repo --goal ./goal.md --run run_xx --mode unlimit
# 恢复一个已有 run
mylab start --run run_xx --mode unlimit

Manage Trials

# 先切到要管理的 run
mylab run use run_xx
# 列出当前 run 的 trial
mylab trial ls
# 查看某个 trial
mylab trial cat trial-001
# 删除某个 trial
mylab trial rm trial-001

Documentation

Refer to the documentation for more information on MyLab:

  • Overview: 项目目标、核心工作方式和设计边界
  • Concepts: run、trial、trial.md、shared asset、Telegram guidance、workflow skill
  • CLI Reference: 常用命令、运行方式和低级工具命令
  • Layout: run 根目录与 trial 目录结构说明

Metadata

Release files for mylab 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mylab 0.1.1
File Size Uploaded Provenance
mylab-0.1.1.tar.gz 80.9 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mylab 0.1.1
File Interpreter ABI Platform
mylab-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 158.5 kB

Release files / mylab-0.1.1.tar.gz

Download URL mylab-0.1.1.tar.gz
Size 80.9 kB
Tags Source
SHA-256 checksum
How to use checksums
951af55226ba8b36f20ee77a7ff9dc86e9846bbeeeb849ea0f844be0f18bf5fb
BLAKE2b-256 checksum
How to use checksums
1c1bd609b4aff7d73c1c396d575e6b77bd5934a1cfa3dbdd50f8f5d0c70f3d35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 22, 2026.

Transparency log

Release files / mylab-0.1.1-py3-none-any.whl

Download URL mylab-0.1.1-py3-none-any.whl
Size 77.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d77bf12bb997953100832cdfaa129004f9bd18ba0f30dd019c38f42e266670b9
BLAKE2b-256 checksum
How to use checksums
ec284aa2b76f6bfd8118b3bbf898d1e6a19059f511c759810758c46c895dae1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 22, 2026.

Transparency log

Security for mylab 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mylab-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page