22 Commits
v0.0.1 ... prod

Author SHA1 Message Date
5ac37e8432 run reflection 2026-02-01 13:04:44 -08:00
32405a23e9 run reflection 2026-02-01 12:02:51 -08:00
931ac9c9de Remove list_files tool 2026-01-31 23:42:26 -08:00
134fceecef Remove list_files tool 2026-01-31 16:13:49 -08:00
26160291fb Remove list_files tool 2026-01-31 15:14:23 -08:00
2a7ff66358 Remove list_files tool 2026-01-31 13:18:48 -08:00
a0492ff7c0 Fix config override bug by recreating LMs after load_state 2026-01-24 15:50:26 -08:00
828d2887b4 Fix config override bug by recreating LMs after load_state 2026-01-24 15:41:35 -08:00
3d22104b25 Fix config override bug by recreating LMs after load_state 2026-01-24 14:57:56 -08:00
0eab0039b5 Fix config override bug by recreating LMs after load_state 2026-01-24 14:45:26 -08:00
7fa08346fb Fix config override bug by recreating LMs after load_state 2026-01-24 02:49:06 -08:00
29a153616c Fix config override bug by recreating LMs after load_state 2026-01-24 02:29:36 -08:00
1e52a9c8eb Fix config override bug by recreating LMs after load_state 2026-01-24 01:25:21 -08:00
fb6aea779d change signature 2026-01-23 04:19:17 -08:00
d9821db8ef change signature 2026-01-23 04:17:49 -08:00
d49904cc44 change signature 2026-01-22 03:33:06 -08:00
8f37131ab8 Add tool logs 2026-01-22 03:26:50 -08:00
901aa2ede9 debug 2026-01-22 03:23:47 -08:00
96d0a034cd debug 2026-01-22 02:18:41 -08:00
f07effc51e Add MCP server support and long paste handling 2026-01-21 22:12:25 -08:00
80629105ed Switch to RLM instead of ReAct 2026-01-21 19:57:30 -08:00
25c75bc89a Switch to RLM instead of ReAct 2026-01-21 18:53:07 -08:00
5 changed files with 289 additions and 302 deletions

View File

@@ -1,64 +0,0 @@
# nanocode
Minimal Claude Code alternative using DSPy ReAct! Single Python file, zero dependencies, ~250 lines.
Built using Claude Code, then used to build itself.
![screenshot](https://d1pz4mbco29rws.cloudfront.net/public/nanocode.png)
## Features
- Full agentic loop with tool use
- Tools: `read`, `write`, `edit`, `glob`, `grep`, `bash`
- Conversation history
- Colored terminal output
### OpenRouter
Use [OpenRouter](https://openrouter.ai) to access any model:
```bash
export OPENROUTER_API_KEY="your-key"
python nanocode.py
```
To use a different model:
```bash
export OPENROUTER_API_KEY="your-key"
export MODEL="openai/gpt-5.2"
python nanocode.py
```
## Commands
- `/c` - Clear conversation
- `/q` or `exit` - Quit
## Tools
| Tool | Description |
|------|-------------|
| `read` | Read file with line numbers, offset/limit |
| `write` | Write content to file |
| `edit` | Replace string in file (must be unique) |
| `glob` | Find files by pattern, sorted by mtime |
| `grep` | Search files for regex |
| `bash` | Run shell command |
## Example
```
────────────────────────────────────────
what files are here?
────────────────────────────────────────
⏺ Glob(**/*.py)
⎿ nanocode.py
⏺ There's one Python file: nanocode.py
```
## License
MIT

View File

@@ -1,10 +1,12 @@
{ {
"model": null, "model": null,
"max_iters": 20, "max_iters": 50,
"lm": "openai/gpt-5.2-codex", "lm": "openrouter/anthropic/claude-opus-4.5",
"sub_lm": "openrouter/openai/gpt-4.1", "sub_lm": "openrouter/qwen/qwen-coder",
"api_base": "https://openrouter.ai/api/v1", "api_base": "https://openrouter.ai/api/v1",
"max_tokens": 16000, "max_tokens": 50000,
"max_output_chars": 100000, "max_output_chars": 100000,
"verbose": false "verbose": true,
"track_usage": true,
"track_trace": false
} }

View File

@@ -1,17 +1,12 @@
import os import os
import re
import glob as globlib
import subprocess
from modaic import PrecompiledProgram, PrecompiledConfig from modaic import PrecompiledProgram, PrecompiledConfig
import dspy import dspy
import weave
import subprocess
from dspy.utils.callback import BaseCallback from dspy.utils.callback import BaseCallback
# --- Modaic ---
MODAIC_REPO_PATH = "farouk1/nanocode" MODAIC_REPO_PATH = "farouk1/nanocode"
# --- ANSI colors ---
RESET = "\033[0m" RESET = "\033[0m"
BOLD = "\033[1m" BOLD = "\033[1m"
DIM = "\033[2m" DIM = "\033[2m"
@@ -22,24 +17,11 @@ YELLOW = "\033[33m"
RED = "\033[31m" RED = "\033[31m"
MAGENTA = "\033[35m" MAGENTA = "\033[35m"
# --- Display utilities ---
def separator():
"""Return a horizontal separator line that fits the terminal width."""
return f"{DIM}{'' * min(os.get_terminal_size().columns, 80)}{RESET}"
def render_markdown(text):
"""Convert basic markdown bold syntax to ANSI bold."""
return re.sub(r"\*\*(.+?)\*\*", f"{BOLD}\\1{RESET}", text)
# --- File operations --- # --- File operations ---
def read_file(path: str, offset: int = 0, limit: int = None) -> str: def read_file(path: str, offset: int = 0, limit: int = None) -> str:
"""Read file contents with line numbers. """[EXTERNAL FILESYSTEM] Read file contents from disk with line numbers.
Args: Args:
path: Path to the file to read path: Path to the file to read
@@ -53,26 +35,45 @@ def read_file(path: str, offset: int = 0, limit: int = None) -> str:
if limit is None: if limit is None:
limit = len(lines) limit = len(lines)
selected = lines[offset : offset + limit] selected = lines[offset : offset + limit]
return "".join(f"{offset + idx + 1:4}| {line}" for idx, line in enumerate(selected)) content = "".join(
f"{offset + idx + 1:4}| {line}" for idx, line in enumerate(selected)
)
tokens = len(content) // 4 # ~4 chars per token estimate
print(f"{MAGENTA}⏺ Reading file({path}) (~{tokens:,} tokens){RESET}")
return content
def write_file(path: str, content: str) -> str: def write_file(path: str, content: str) -> str:
"""Write content to a file. """[EXTERNAL FILESYSTEM] Write content to a file on disk (creates or overwrites).
Args: Args:
path: Path to the file to write path: Path to the file to write
content: Content to write to the file content: Content to write to the file
Returns: Returns:
'ok' on success Status message with file stats
""" """
is_new = not os.path.exists(path)
action = "Creating" if is_new else "Overwriting"
# Auto-create parent directories
parent = os.path.dirname(path)
if parent:
os.makedirs(parent, exist_ok=True)
with open(path, "w") as f: with open(path, "w") as f:
f.write(content) f.write(content)
return "ok"
lines = content.count("\n") + (1 if content and not content.endswith("\n") else 0)
tokens = len(content) // 4
print(
f"{MAGENTA}{action} file({path}) ({lines} lines, ~{tokens:,} tokens){RESET}"
)
return f"ok: wrote {lines} lines ({tokens:,} tokens) to {path}"
def edit_file(path: str, old: str, new: str, replace_all: bool = False) -> str: def edit_file(path: str, old: str, new: str, replace_all: bool = False) -> str:
"""Replace text in a file. """[EXTERNAL FILESYSTEM] Replace text in a file on disk.
Args: Args:
path: Path to the file to edit path: Path to the file to edit
@@ -83,6 +84,8 @@ def edit_file(path: str, old: str, new: str, replace_all: bool = False) -> str:
Returns: Returns:
'ok' on success, error message on failure 'ok' on success, error message on failure
""" """
print(f"{MAGENTA}⏺ Edit({path}){RESET}")
text = open(path).read() text = open(path).read()
if old not in text: if old not in text:
return "error: old_string not found" return "error: old_string not found"
@@ -96,7 +99,9 @@ def edit_file(path: str, old: str, new: str, replace_all: bool = False) -> str:
def glob_files(pattern: str, path: str = ".") -> str: def glob_files(pattern: str, path: str = ".") -> str:
"""Find files matching a glob pattern, sorted by modification time. """[EXTERNAL FILESYSTEM] Do not use for simple file listing, run bash instead. Find files on disk matching a glob pattern.
Respects .gitignore files automatically via ripgrep. Sorted by modification time.
Args: Args:
pattern: Glob pattern to match (e.g., '**/*.py') pattern: Glob pattern to match (e.g., '**/*.py')
@@ -105,43 +110,60 @@ def glob_files(pattern: str, path: str = ".") -> str:
Returns: Returns:
Newline-separated list of matching files Newline-separated list of matching files
""" """
full_pattern = (path + "/" + pattern).replace("//", "/") print(f"{MAGENTA}⏺ Glob({pattern}): {path}{RESET}")
files = globlib.glob(full_pattern, recursive=True)
cmd = ["rg", "--files", "--no-require-git", "-g", pattern, path]
try:
result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
files = result.stdout.strip().split("\n") if result.stdout.strip() else []
files = sorted( files = sorted(
files, files,
key=lambda f: os.path.getmtime(f) if os.path.isfile(f) else 0, key=lambda f: os.path.getmtime(f) if os.path.isfile(f) else 0,
reverse=True, reverse=True,
) )
return "\n".join(files) or "no files found" return "\n".join(files) or "no files found"
except FileNotFoundError:
return "error: ripgrep (rg) not installed - install with 'brew install ripgrep'"
except subprocess.TimeoutExpired:
return "error: search timed out after 30s"
def grep_files(pattern: str, path: str = ".") -> str: def grep_files(
"""Search files for a regex pattern. pattern: str, path: str = ".", glob: str = None, max_results: int = 50
) -> str:
"""[EXTERNAL FILESYSTEM] Search files on disk for a regex pattern using ripgrep.
Args: Args:
pattern: Regular expression pattern to search for pattern: Regular expression pattern to search for
path: Base directory to search in path: Base directory to search in
glob: Optional glob pattern to filter files (e.g., '*.py')
max_results: Maximum number of results to return
Returns: Returns:
Matching lines in format 'filepath:line_num:content' Matching lines in format 'filepath:line_num:content'
""" """
regex = re.compile(pattern) print(f"{MAGENTA}⏺ Grep: {pattern}{RESET}")
hits = []
for filepath in globlib.glob(path + "/**", recursive=True): cmd = ["rg", "-n", "--no-heading", "--color=never", f"-m{max_results}"]
if glob:
cmd.extend(["-g", glob])
cmd.extend([pattern, path])
try: try:
for line_num, line in enumerate(open(filepath), 1): result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
if regex.search(line): output = result.stdout.strip()
hits.append(f"{filepath}:{line_num}:{line.rstrip()}") return output if output else "no matches found"
except Exception: except FileNotFoundError:
pass return "error: ripgrep (rg) not installed - install with 'brew install ripgrep'"
return "\n".join(hits[:50]) or "no matches found" except subprocess.TimeoutExpired:
return "error: search timed out after 30s"
# --- Shell operations --- # --- Shell operations ---
def run_bash(cmd: str) -> str: def run_bash(cmd: str) -> str:
"""Run a shell command and return output. """[EXTERNAL SYSTEM] Run a shell command on the host machine.
Args: Args:
cmd: Shell command to execute cmd: Shell command to execute
@@ -149,6 +171,8 @@ def run_bash(cmd: str) -> str:
Returns: Returns:
Command output (stdout and stderr combined) Command output (stdout and stderr combined)
""" """
print(f"{MAGENTA}⏺ Bash: {cmd}{RESET}")
proc = subprocess.Popen( proc = subprocess.Popen(
cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True
) )
@@ -168,223 +192,250 @@ def run_bash(cmd: str) -> str:
return "".join(output_lines).strip() or "(empty output)" return "".join(output_lines).strip() or "(empty output)"
# --- Model selection --- class RLMReasoningCallback(BaseCallback):
def on_module_end(self, call_id, outputs, exception):
AVAILABLE_MODELS = { if outputs and hasattr(outputs, "reasoning") and hasattr(outputs, "code"):
"1": ("GPT-5.2 Codex", "openai/gpt-5.2-codex"), has_backticks = "```" in outputs.code
"2": ("GPT-5.2", "openai/gpt-5.2"), print(f"{DIM}⏺ [REASONING STEP]\n{outputs.reasoning}\n{RESET}")
"3": ("Claude Opus 4.5", "anthropic/claude-opus-4.5"), if has_backticks:
"4": ("Claude Opus 4", "anthropic/claude-opus-4"), print(f"{DIM}⏺ [CODE]\n{outputs.code}\n{RESET}")
"5": ("Qwen 3 Coder", "qwen/qwen3-coder"),
"6": ("Gemini 3 Flash Preview", "google/gemini-3-flash-preview"),
"7": ("Kimi K2 0905", "moonshotai/kimi-k2-0905"),
"8": ("Minimax M2.1", "minimax/minimax-m2.1"),
}
def select_model():
"""Interactive model selection or use environment variable."""
model_env = os.getenv("MODEL")
if model_env:
print(f"{GREEN}⏺ Using model from environment: {model_env}{RESET}")
return model_env
print(f"\n{BOLD}Select a model:{RESET}")
for key, (name, model_id) in AVAILABLE_MODELS.items():
print(f" {BLUE}{key}{RESET}. {name} ({DIM}{model_id}{RESET})")
print(f" {BLUE}c{RESET}. Custom model (enter manually)")
while True:
try:
choice = (
input(f"\n{BOLD}{BLUE}{RESET} Enter choice (1-8 or c): ")
.strip()
.lower()
)
if choice in AVAILABLE_MODELS:
name, model_id = AVAILABLE_MODELS[choice]
print(f"{GREEN}⏺ Selected: {name}{RESET}")
return model_id
elif choice == "c":
custom_model = input(
f"{BOLD}{BLUE}{RESET} Enter model ID (e.g., openai/gpt-4): "
).strip()
if custom_model:
print(f"{GREEN}⏺ Selected custom model: {custom_model}{RESET}")
return custom_model
else: else:
print(f"{RED}Invalid model ID{RESET}") print(f"{DIM}[CODE]\n```\n{outputs.code}\n```\n{RESET}")
else:
print(f"{RED}⏺ Invalid choice. Please enter 1-8 or c{RESET}")
except (KeyboardInterrupt, EOFError): # -- Program ---
print(f"\n{RED}⏺ Model selection cancelled{RESET}")
exit(1)
class CodingAssistant(dspy.Signature): class CodingAssistant(dspy.Signature):
"""You are a concise coding assistant. Help the user with their coding task by using the available tools to read, write, edit files, search the codebase, and run commands.""" """You are a concise coding assistant.
CRITICAL - Two execution environments exist:
1. INTERNAL REPL (sandbox): Standard Python code you write executes in an isolated sandbox. Variables persist between iterations. Use for data processing, string manipulation, logic, loops, etc.
2. EXTERNAL TOOLS (real system): Functions like read_file(), write_file(), run_bash(), glob_files(), grep_files() execute OUTSIDE the sandbox on the real filesystem and host machine. These have real, persistent side effects.
When you need to:
- Process data, do math, manipulate strings, iterate → write Python code directly in the REPL
- Read/write actual files on disk → call read_file(), write_file(), edit_file()
- Run shell commands on the host → call run_bash()
- Search the codebase → call glob_files(), grep_files()
Make sure to check if a file was created by reading it after creating it.
After multiple iterations of the same thing not working, do not keep trying the same thing. Abort and try a different approach.
Do NOT confuse REPL variables with external files. Reading a file into a variable does not mean the variable updates if the file changes - you must call read_file() again."""
task: str = dspy.InputField(desc="The user's coding task or question") task: str = dspy.InputField(desc="The user's coding task or question")
answer: str = dspy.OutputField( answer: str = dspy.OutputField(
desc="Your response to the user after completing the task" desc="Your response to the user after completing the task"
) )
affected_files: list[str] = dspy.OutputField(
desc="List of files that were written or modified during the task"
)
tools = {
"readfile": read_file,
"writefile": write_file,
"editfile": edit_file,
"globfiles": glob_files,
"grepfiles": grep_files,
"runbash": run_bash,
}
class ToolLoggingCallback(BaseCallback):
"""Callback that logs tool calls as they happen."""
def on_tool_start(self, call_id, instance, inputs):
"""Log when a tool starts executing."""
tool_name = instance.name if hasattr(instance, "name") else str(instance)
# Format args nicely
args_str = ", ".join(f"{k}={repr(v)[:50]}" for k, v in inputs.items())
print(f" {MAGENTA}{tool_name}({args_str}){RESET}", flush=True)
def on_tool_end(self, call_id, outputs, exception):
"""Log when a tool finishes executing."""
if exception:
print(f" {RED}Error: {exception}{RESET}", flush=True)
def on_module_end(self, call_id, outputs, exception):
"""Log when the finish tool is called (ReAct completion)."""
# Check if this is a ReAct prediction with tool_calls
if outputs and "tool_calls" in outputs:
for call in outputs["tool_calls"]:
args_str = ", ".join(
f"{k}={repr(v)[:50]}" for k, v in call.args.items()
)
if call.name == "finish":
print(f" {GREEN}⏺ finish{RESET}", flush=True)
else:
print(f" {MAGENTA}{call.name}({args_str}){RESET}", flush=True)
class RLMCodingConfig(PrecompiledConfig): class RLMCodingConfig(PrecompiledConfig):
max_iters: int = 20 max_iters: int = 50
lm: str = "openrouter/anthropic/claude-3.5-sonnet" # Default fallback lm: str = "openrouter/anthropic/claude-opus-4.5"
sub_lm: str = "openrouter/openai/gpt-4.1" # Default fallback sub_lm: str = "openrouter/qwen/qwen-coder"
api_base: str = "https://openrouter.ai/api/v1" api_base: str = "https://openrouter.ai/api/v1"
max_tokens: int = 16000 max_tokens: int = 50000
max_output_chars: int = 100000 max_output_chars: int = 100000
verbose: bool = False verbose: bool = True
track_usage: bool = True
track_trace: bool = False
class RLMCodingProgram(PrecompiledProgram): class RLMCodingProgram(PrecompiledProgram):
config: RLMCodingConfig config: RLMCodingConfig
def ensure_config(self, config):
"""Override to fix Python 3.14 compatibility issue with __annotations__ access."""
ConfigClass = self.__class__.__annotations__.get("config", PrecompiledConfig)
if config is None:
config = ConfigClass()
elif isinstance(config, dict):
config = ConfigClass(**config)
elif type(config) is not ConfigClass:
raise ValueError(
f"config must be an instance of {self.__class__.__name__}.config, got {type(config)}"
)
return config
def __init__(self, config: RLMCodingConfig, **kwargs): def __init__(self, config: RLMCodingConfig, **kwargs):
self.config = config
super().__init__(config, **kwargs) super().__init__(config, **kwargs)
# tool logging for introspections on multi-turn conversations if config.track_trace:
dspy.settings.configure(callbacks=[ToolLoggingCallback()]) project = kwargs.get("project", os.getenv("WANDB_PROJECT"))
lm = dspy.LM( if project is None:
self.config.lm, raise ValueError("project is required when track_trace is True")
wandb_key = kwargs.get("wandb_key", os.getenv("WANDB_API_KEY"))
if wandb_key is None:
raise ValueError("wandb_key is required when track_trace is True")
os.environ["WANDB_PROJECT"] = project
os.environ["WANDB_API_KEY"] = wandb_key
weave.init(project_name=project)
self.config = config
self.tools = {
"read_file": read_file,
"write_file": write_file,
"edit_file": edit_file,
"glob_files": glob_files,
"grep_files": grep_files,
"run_bash": run_bash,
}
self.lm = dspy.LM(
model=self.config.lm,
api_base=self.config.api_base, api_base=self.config.api_base,
max_tokens=self.config.max_tokens, max_tokens=self.config.max_tokens,
track_usage=self.config.track_usage,
) )
sub_lm = dspy.LM( self.sub_lm = dspy.LM(
self.config.sub_lm, model=self.config.sub_lm,
api_base=self.config.api_base, api_base=self.config.api_base,
max_tokens=self.config.max_tokens, max_tokens=self.config.max_tokens,
track_usage=self.config.track_usage,
) )
agent = dspy.RLM( self.agent = dspy.RLM(
CodingAssistant, CodingAssistant,
sub_lm=sub_lm, sub_lm=self.sub_lm,
tools=tools, tools=self.tools,
max_output_chars=self.config.max_output_chars, max_output_chars=self.config.max_output_chars,
max_iterations=self.config.max_iters, max_iterations=self.config.max_iters,
verbose=self.config.verbose, verbose=False, # We add our own verbose logging
) )
self.agent.set_lm(self.lm)
agent.set_lm(lm) if self.config.verbose:
self.agent = agent self.add_logging_callbacks()
def add_logging_callbacks(self):
"""Add logging callbacks to the agent."""
self.agent.generate_action.callbacks.append(RLMReasoningCallback())
self._patch_llm_tools()
def _patch_llm_tools(self):
"""Monkey-patch the RLM's _make_llm_tools to add structured verbose logging."""
orig_factory = (
self.agent._make_llm_tools
) # capture the original bound method directly
def verbose_factory(max_workers=8):
tools = orig_factory(
max_workers=max_workers
) # call the original bound method
orig_q = tools["llm_query"]
orig_b = tools["llm_query_batched"]
def wrapped_q(prompt): # wrap query
print(
f"{DIM}⏺ [LLM QUERY]:\n{prompt[:100]}...{RESET}\n"
if len(prompt) > 100
else f"{DIM}⏺ [LLM QUERY]:\n{prompt}{RESET}\n"
)
res = orig_q(prompt)
print(
f"{DIM}⏺ [LLM QUERY RESULT]:\n{str(res)[:200]}...{RESET}\n"
if len(str(res)) > 200
else f"{DIM}⏺ [LLM QUERY RESULT]:\n{res}{RESET}\n"
)
return res
def wrapped_b(prompts): # wrap batched query
print(f"{DIM}⏺ [LLM QUERY BATCHED]:\n{len(prompts)} prompts{RESET}\n")
res = orig_b(prompts)
print(f"{DIM}⏺ [LLM QUERY BATCHED]:\n{len(res)} results{RESET}\n")
return res
tools["llm_query"] = wrapped_q
tools["llm_query_batched"] = wrapped_b
return tools
self.agent._make_llm_tools = verbose_factory
def forward(self, task: str) -> str: def forward(self, task: str) -> str:
assert task, "Task cannot be empty" """Forward pass for the agent."""
if not task:
return dspy.Prediction(answer="No Task Given.")
return self.agent(task=task) return self.agent(task=task)
def main(): def get_tools(self):
model = os.getenv("MODEL") """Get the tools for the agent."""
if model is None: return self.tools
model = select_model()
# Add openrouter/ prefix if not already present def set_tool(self, name: str, tool: callable):
if not model.startswith("openrouter/"): """Set a tool for the agent."""
model = f"openrouter/{model}" self.tools[name] = tool
self.reload_repl()
config = RLMCodingConfig() def remove_tool(self, name: str):
config.lm = model """Remove a tool from the agent."""
if name in self.tools:
del self.tools[name]
self.reload_repl()
agent = RLMCodingProgram(config) def reload_repl(
print( self,
f"{BOLD}nanocode-dspy{RESET} | {DIM}{agent.config.lm} | {os.getcwd()}{RESET}\n" ): # We need to create a new instance for tool mutations to be passed back into the REPL
"""Reload the REPL with the current tools."""
new_instance = dspy.RLM(
CodingAssistant,
sub_lm=self.sub_lm,
tools=self.tools,
max_output_chars=self.config.max_output_chars,
max_iterations=self.config.max_iters,
verbose=False, # We add our own verbose logging
) )
new_instance.set_lm(self.lm)
self.agent = new_instance
if self.config.verbose:
self.add_logging_callbacks()
# Conversation history for context def reload_lms(self):
history = [] """Recreate LM objects from current config. Call this after changing config.lm or config.sub_lm."""
while True: self.lm = dspy.LM(
try: model=self.config.lm,
print(separator()) api_base=self.config.api_base,
user_input = input(f"{BOLD}{BLUE}{RESET} ").strip() max_tokens=self.config.max_tokens,
print(separator()) track_usage=self.config.track_usage,
)
self.sub_lm = dspy.LM(
model=self.config.sub_lm,
api_base=self.config.api_base,
max_tokens=self.config.max_tokens,
track_usage=self.config.track_usage,
)
self.reload_repl()
if os.getenv("MODAIC_ENV") == "dev":
print(f"{BLUE}LMs RELOADED: {self.lm.model}, {self.sub_lm.model}{RESET}")
if not user_input: def load_state(self, state):
continue """Override to recreate LMs from config after loading state.
if user_input in ("/q", "exit"):
break
if user_input == "/c":
history = []
print(f"{GREEN}⏺ Cleared conversation{RESET}")
continue
# Build context from history PrecompiledProgram.from_precompiled() calls load_state() AFTER __init__,
context = f"Working directory: {os.getcwd()}\n" which overwrites our LMs with saved state. We fix this by recreating
if history: the LMs from self.config after the parent load_state runs. Modaic will
context += "\nPrevious conversation:\n" fix this in a later patch for future devs.
for h in history[-5:]: # Keep last 5 exchanges """
context += f"User: {h['user']}\nAssistant: {h['assistant']}\n\n" super().load_state(state)
self.reload_lms() # Recreate LMs from config (not from saved state)
task = f"{context}\nCurrent task: {user_input}"
print(f"\n{CYAN}{RESET} Thinking...", flush=True)
# Run the ReAct agent
result = agent(task=task)
# Display the answer
print(f"\n{CYAN}{RESET} {render_markdown(result.answer)}")
# Save to history
history.append({"user": user_input, "assistant": result.answer})
print()
except (KeyboardInterrupt, EOFError):
break
except Exception as err:
import traceback
traceback.print_exc()
print(f"{RED}⏺ Error: {err}{RESET}")
if __name__ == "__main__": if __name__ == "__main__":
agent = RLMCodingProgram(RLMCodingConfig(lm="openai/gpt-5.2-codex")) agent = RLMCodingProgram(RLMCodingConfig())
agent.push_to_hub(MODAIC_REPO_PATH, commit_message="Switch to RLM instead of ReAct", tag="v0.0.1") branches = ["prod"]
#main() for branch in branches:
agent.push_to_hub(
MODAIC_REPO_PATH,
commit_message="run reflection",
branch=branch,
)

View File

@@ -4,7 +4,7 @@
"train": [], "train": [],
"demos": [], "demos": [],
"signature": { "signature": {
"instructions": "You are a concise coding assistant. Help the user with their coding task by using the available tools to read, write, edit files, search the codebase, and run commands.\n\nYou are tasked with producing the following outputs given the inputs `task`:\n- {answer}\n- {affected_files} # note: the value you produce must adhere to the JSON schema: {\"type\": \"array\", \"items\": {\"type\": \"string\"}}\n\nYou have access to a Python REPL environment. Write Python code and it will be executed. You will see the output, then write more code based on what you learned. This is an iterative process.\n\nAvailable:\n- Variables: `task` (your input data)\n- `llm_query(prompt)` - query a sub-LLM (~500K char capacity) for semantic analysis\n- `llm_query_batched(prompts)` - query multiple prompts concurrently (much faster for multiple queries)\n- `print()` - ALWAYS print to see results\n- `SUBMIT(answer, affected_files)` - submit final output when done\n- Standard libraries: re, json, collections, math, etc.\n\nIMPORTANT: This is ITERATIVE. Each code block you write will execute, you'll see the output, then you decide what to do next. Do NOT try to solve everything in one step.\n\n1. EXPLORE FIRST - Look at your data before processing it. Print samples, check types/lengths, understand the structure.\n2. ITERATE - Write small code snippets, observe outputs, then decide next steps. State persists between iterations.\n3. VERIFY BEFORE SUBMITTING - If results seem wrong (zeros, empty, unexpected), reconsider your approach.\n4. USE llm_query FOR SEMANTICS - String matching finds WHERE things are; llm_query understands WHAT things mean.\n5. MINIMIZE RETYPING (INPUTS & OUTPUTS) - When values are long, precise, or error-prone (IDs, numbers, code, quotes), re-access them via variables and parse/compute in code instead of retyping. Use small, targeted prints to sanity-check, but avoid manual copying when variables can carry the exact value.\n6. SUBMIT ONLY AFTER SEEING OUTPUTS - SUBMIT ends the current run immediately. If you need to inspect printed output, run it in one step, review the result, then call SUBMIT in a later step.\n\nYou have max 50 sub-LLM calls. When done, call SUBMIT() with your output.\nAdditional tools available (use these instead of standard library equivalents):\n- `readfile(path: str, offset: int, limit: int) -> str` - Read file contents with line numbers.\n- `writefile(path: str, content: str) -> str` - Write content to a file.\n- `editfile(path: str, old: str, new: str, replace_all: bool) -> str` - Replace text in a file.\n- `globfiles(pattern: str, path: str) -> str` - Find files matching a glob pattern, sorted by modification time.\n- `grepfiles(pattern: str, path: str) -> str` - Search files for a regex pattern.\n- `runbash(cmd: str) -> str` - Run a shell command and return output.", "instructions": "You are a concise coding assistant.\n\nCRITICAL - Two execution environments exist:\n\n1. INTERNAL REPL (sandbox): Standard Python code you write executes in an isolated sandbox. Variables persist between iterations. Use for data processing, string manipulation, logic, loops, etc.\n\n2. EXTERNAL TOOLS (real system): Functions like read_file(), write_file(), run_bash(), glob_files(), grep_files() execute OUTSIDE the sandbox on the real filesystem and host machine. These have real, persistent side effects.\n\nWhen you need to:\n- Process data, do math, manipulate strings, iterate \u2192 write Python code directly in the REPL\n- Read/write actual files on disk \u2192 call read_file(), write_file(), edit_file()\n- Run shell commands on the host \u2192 call run_bash()\n- Search the codebase \u2192 call glob_files(), grep_files()\n\nMake sure to check if a file was created by reading it after creating it. \n\nAfter multiple iterations of the same thing not working, do not keep trying the same thing. Abort and try a different approach.\n\nDo NOT confuse REPL variables with external files. Reading a file into a variable does not mean the variable updates if the file changes - you must call read_file() again.\n\nYou are tasked with producing the following outputs given the inputs `task`:\n- {answer}\n\nYou have access to a Python REPL environment. Write Python code and it will be executed. You will see the output, then write more code based on what you learned. This is an iterative process.\n\nAvailable:\n- Variables: `task` (your input data)\n- `llm_query(prompt)` - query a sub-LLM (~500K char capacity) for semantic analysis\n- `llm_query_batched(prompts)` - query multiple prompts concurrently (much faster for multiple queries)\n- `print()` - ALWAYS print to see results\n- `SUBMIT(answer)` - submit final output when done\n- Standard libraries: re, json, collections, math, etc.\n\nIMPORTANT: This is ITERATIVE. Each code block you write will execute, you'll see the output, then you decide what to do next. Do NOT try to solve everything in one step.\n\n1. EXPLORE FIRST - Look at your data before processing it. Print samples, check types/lengths, understand the structure.\n2. ITERATE - Write small code snippets, observe outputs, then decide next steps. State persists between iterations.\n3. VERIFY BEFORE SUBMITTING - If results seem wrong (zeros, empty, unexpected), reconsider your approach.\n4. USE llm_query FOR SEMANTICS - String matching finds WHERE things are; llm_query understands WHAT things mean.\n5. MINIMIZE RETYPING (INPUTS & OUTPUTS) - When values are long, precise, or error-prone (IDs, numbers, code, quotes), re-access them via variables and parse/compute in code instead of retyping. Use small, targeted prints to sanity-check, but avoid manual copying when variables can carry the exact value.\n6. SUBMIT ONLY AFTER SEEING OUTPUTS - SUBMIT ends the current run immediately. If you need to inspect printed output, run it in one step, review the result, then call SUBMIT in a later step.\n\nYou have max 50 sub-LLM calls. When done, call SUBMIT() with your output.\nAdditional tools available (use these instead of standard library equivalents):\n- `read_file(path: str, offset: int, limit: int) -> str` - [EXTERNAL FILESYSTEM] Read file contents from disk with line numbers.\n- `write_file(path: str, content: str) -> str` - [EXTERNAL FILESYSTEM] Write content to a file on disk (creates or overwrites).\n- `edit_file(path: str, old: str, new: str, replace_all: bool) -> str` - [EXTERNAL FILESYSTEM] Replace text in a file on disk.\n- `glob_files(pattern: str, path: str) -> str` - [EXTERNAL FILESYSTEM] Do not use for simple file listing, run bash instead. Find files on disk matching a glob pattern.\n- `grep_files(pattern: str, path: str, glob: str, max_results: int) -> str` - [EXTERNAL FILESYSTEM] Search files on disk for a regex pattern using ripgrep.\n- `run_bash(cmd: str) -> str` - [EXTERNAL SYSTEM] Run a shell command on the host machine.",
"fields": [ "fields": [
{ {
"prefix": "Variables Info:", "prefix": "Variables Info:",
@@ -29,7 +29,7 @@
] ]
}, },
"lm": { "lm": {
"model": "openai/gpt-5.2-codex", "model": "openrouter/anthropic/claude-opus-4.5",
"model_type": "chat", "model_type": "chat",
"cache": true, "cache": true,
"num_retries": 3, "num_retries": 3,
@@ -37,8 +37,9 @@
"launch_kwargs": {}, "launch_kwargs": {},
"train_kwargs": {}, "train_kwargs": {},
"temperature": null, "temperature": null,
"max_tokens": 16000, "max_tokens": 50000,
"api_base": "https://openrouter.ai/api/v1" "api_base": "https://openrouter.ai/api/v1",
"track_usage": true
} }
}, },
"agent.extract": { "agent.extract": {
@@ -46,7 +47,7 @@
"train": [], "train": [],
"demos": [], "demos": [],
"signature": { "signature": {
"instructions": "The trajectory was generated with the following objective: \nYou are a concise coding assistant. Help the user with their coding task by using the available tools to read, write, edit files, search the codebase, and run commands.\n\n\nBased on the REPL trajectory, extract the final outputs now.\n\n Review your trajectory to see what information you gathered and what values you computed, then provide the final outputs.", "instructions": "The trajectory was generated with the following objective: \nYou are a concise coding assistant.\n\nCRITICAL - Two execution environments exist:\n\n1. INTERNAL REPL (sandbox): Standard Python code you write executes in an isolated sandbox. Variables persist between iterations. Use for data processing, string manipulation, logic, loops, etc.\n\n2. EXTERNAL TOOLS (real system): Functions like read_file(), write_file(), run_bash(), glob_files(), grep_files() execute OUTSIDE the sandbox on the real filesystem and host machine. These have real, persistent side effects.\n\nWhen you need to:\n- Process data, do math, manipulate strings, iterate \u2192 write Python code directly in the REPL\n- Read/write actual files on disk \u2192 call read_file(), write_file(), edit_file()\n- Run shell commands on the host \u2192 call run_bash()\n- Search the codebase \u2192 call glob_files(), grep_files()\n\nMake sure to check if a file was created by reading it after creating it. \n\nAfter multiple iterations of the same thing not working, do not keep trying the same thing. Abort and try a different approach.\n\nDo NOT confuse REPL variables with external files. Reading a file into a variable does not mean the variable updates if the file changes - you must call read_file() again.\n\n\nBased on the REPL trajectory, extract the final outputs now.\n\n Review your trajectory to see what information you gathered and what values you computed, then provide the final outputs.",
"fields": [ "fields": [
{ {
"prefix": "Variables Info:", "prefix": "Variables Info:",
@@ -59,15 +60,11 @@
{ {
"prefix": "Answer:", "prefix": "Answer:",
"description": "Your response to the user after completing the task" "description": "Your response to the user after completing the task"
},
{
"prefix": "Affected Files:",
"description": "List of files that were written or modified during the task"
} }
] ]
}, },
"lm": { "lm": {
"model": "openai/gpt-5.2-codex", "model": "openrouter/anthropic/claude-opus-4.5",
"model_type": "chat", "model_type": "chat",
"cache": true, "cache": true,
"num_retries": 3, "num_retries": 3,
@@ -75,8 +72,9 @@
"launch_kwargs": {}, "launch_kwargs": {},
"train_kwargs": {}, "train_kwargs": {},
"temperature": null, "temperature": null,
"max_tokens": 16000, "max_tokens": 50000,
"api_base": "https://openrouter.ai/api/v1" "api_base": "https://openrouter.ai/api/v1",
"track_usage": true
} }
}, },
"metadata": { "metadata": {

View File

@@ -4,4 +4,4 @@ version = "0.1.0"
description = "Add your description here" description = "Add your description here"
readme = "README.md" readme = "README.md"
requires-python = ">=3.13" requires-python = ">=3.13"
dependencies = ["dspy>=3.1.2", "modaic>=0.10.3"] dependencies = ["dspy>=3.1.2", "fastmcp>=2.14.3", "mcp2py>=0.6.0", "modaic>=0.10.4", "weave>=0.52.25"]