ech0-prime / app.py
workofarttattoo's picture
Fix HF Spaces compatibility issues
7066fbc
#!/usr/bin/env python3
"""
ECH0-PRIME Gradio API Interface
Enables external LLMs to navigate and use QuLab tools through ECH0-PRIME
Copyright (c) 2025 Joshua Hendricks Cole (DBA: Corporation of Light). All Rights Reserved. PATENT PENDING.
"""
import gradio as gr
import json
from typing import Dict, List, Any, Optional
import traceback
from datetime import datetime
import os
import tempfile
# Get output directory (works on HF Spaces and local)
def get_output_dir():
"""Get the output directory for saving sessions"""
if os.path.exists("/tmp"):
# HF Spaces and Unix-like systems
output_dir = "/tmp/ech0_sessions"
else:
# Windows or other systems
output_dir = os.path.join(tempfile.gettempdir(), "ech0_sessions")
os.makedirs(output_dir, exist_ok=True)
return output_dir
# Initialize ECH0-PRIME
ech0_prime = None
ech0_error = None
try:
from ech0_prime_qulab_connector import Ech0PrimeQuLabResearcher
ech0_prime = Ech0PrimeQuLabResearcher()
print("✅ ECH0-PRIME initialized successfully for Gradio API")
except Exception as e:
ech0_error = str(e)
print(f"❌ ECH0-PRIME initialization failed: {e}")
def list_available_labs() -> str:
"""List all available labs in QuLab Infinite"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
try:
labs = ech0_prime.qulab.list_labs()
if not labs:
return """⚠️ **QuLab API may not be running**
Available Labs (from system prompt):
### QUANTUM LABS
- quantum_lab: Quantum computing, teleportation protocols, error correction
- quantum_mechanics_lab: Fundamental quantum simulations
- quantum_computing_lab: Gate operations, circuit design
### BIOLOGICAL LABS
- oncology_lab: Cancer simulations, tumor evolution, treatment optimization
- genetic_variant_analyzer: Genomic analysis, variant impact prediction
- cancer_metabolic_optimizer: Metabolic pathway analysis for cancer treatment
- immune_response_simulator: Immunotherapy modeling
- microbiome_optimizer: Gut microbiome analysis and optimization
- neurotransmitter_optimizer: Brain chemistry modeling
- stem_cell_predictor: Differentiation pathway prediction
- protein_folding_lab: Protein structure prediction
### CHEMISTRY LABS
- chemistry_lab: Molecular simulations, reaction kinetics
- drug_interaction_network: Drug-drug interactions, pharmacology
- materials_lab: Materials science simulations
- organic_chemistry_lab: Organic synthesis planning
- electrochemistry_lab: Electrochemical reactions
### PHYSICS LABS
- physics_engine: Classical and quantum physics simulations
- particle_physics_lab: Particle interactions
- plasma_physics_lab: Plasma dynamics
- condensed_matter_physics_lab: Solid state physics
### ENVIRONMENTAL LABS
- environmental_sim: Climate and environmental modeling
- atmospheric_chemistry_lab: Atmospheric reactions
- renewable_energy_lab: Energy system optimization
### MEDICAL LABS
- cardiovascular_plaque_lab: Atherosclerosis modeling
- metabolic_syndrome_reversal: Metabolic health optimization
- drug_design_lab: Molecular drug design
- clinical_trials_simulation: Trial outcome prediction"""
result = "🔬 **Available QuLab Infinite Labs**\n\n"
for lab in labs:
result += f"• {lab}\n"
return result
except Exception as e:
return f"❌ Failed to list labs: {str(e)}"
def query_ech0_prime(question: str, include_context: bool = True) -> str:
"""Query ECH0-PRIME with a scientific question"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
if not question.strip():
return "Please enter a question"
try:
response = ech0_prime.query_llm(question)
result = f"🤖 **ECH0-PRIME Response**\n\n{response}\n\n"
if include_context:
result += f"---\n**Conversation Length**: {len(ech0_prime.conversation_history)} messages\n"
result += f"**Experiments Run**: {len(ech0_prime.experiment_log)}\n"
return result
except Exception as e:
return f"❌ Query failed: {str(e)}\n\nTraceback:\n{traceback.format_exc()}"
def run_single_experiment(lab: str, experiment_type: str, parameters: str) -> str:
"""Run a single experiment on QuLab Infinite"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
try:
# Parse parameters
if parameters.strip():
try:
params = json.loads(parameters)
except json.JSONDecodeError:
return "❌ Invalid JSON parameters. Please check your input format."
else:
params = {}
# Create experiment dict
experiment = {
"lab": lab,
"experiment_type": experiment_type,
"parameters": params
}
# Run experiment
results = ech0_prime.run_experiment(experiment)
# Format result
result_text = f"🧪 **Experiment Result**\n\n"
result_text += f"**Lab**: {lab}\n"
result_text += f"**Type**: {experiment_type}\n\n"
if "error" in results:
result_text += f"❌ **Error**: {results['error']}\n\n"
if "detail" in results:
result_text += f"**Details**: {results['detail']}"
else:
result_text += f"✅ **Success!**\n\n```json\n{json.dumps(results, indent=2)}\n```"
# Log to ECH0-PRIME
ech0_prime.experiment_log.append({
"experiment": experiment,
"results": results,
"timestamp": datetime.now().isoformat()
})
return result_text
except Exception as e:
return f"❌ Experiment failed: {str(e)}\n\nTraceback:\n{traceback.format_exc()}"
def start_research_session(research_question: str, max_iterations: int = 5) -> str:
"""Start an autonomous research session"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
if not research_question.strip():
return "Please enter a research question"
try:
# Run research loop
results = ech0_prime.research_loop(
research_question,
max_iterations=max_iterations,
verbose=False
)
# Format results
output = f"🔬 **Research Session Complete**\n\n"
output += f"**Question**: {research_question}\n"
output += f"**Iterations**: {results['iterations']}\n\n"
output += "### Experiments Run:\n"
for i, exp in enumerate(results['experiments'], 1):
exp_data = exp['experiment']
output += f"\n**{i}. {exp_data.get('lab')}** - {exp_data.get('experiment_type')}\n"
# Show result status
if 'error' in exp['results']:
output += f" ❌ Error: {exp['results']['error']}\n"
else:
output += f" ✅ Success\n"
output += f"\n### Final Summary:\n\n{results['final_summary']}\n\n"
# Save session
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
output_dir = get_output_dir()
filepath = os.path.join(output_dir, f"ech0_research_gradio_{timestamp}.json")
ech0_prime.save_session(filepath)
output += f"---\n**Session saved to**: `{filepath}`"
return output
except Exception as e:
return f"❌ Research session failed: {str(e)}\n\nTraceback:\n{traceback.format_exc()}"
def get_conversation_history() -> str:
"""Get the current conversation history"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
try:
if not ech0_prime.conversation_history:
return "No conversation history yet. Start by asking a question!"
output = f"💬 **Conversation History** ({len(ech0_prime.conversation_history)} messages)\n\n"
for i, msg in enumerate(ech0_prime.conversation_history[-10:], 1): # Last 10 messages
role = msg['role'].upper()
content = msg['content'][:200] + "..." if len(msg['content']) > 200 else msg['content']
output += f"**{role}**: {content}\n\n"
if len(ech0_prime.conversation_history) > 10:
output += f"_(Showing last 10 of {len(ech0_prime.conversation_history)} messages)_"
return output
except Exception as e:
return f"❌ Failed to get history: {str(e)}"
def get_experiment_log() -> str:
"""Get the experiment log"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
try:
if not ech0_prime.experiment_log:
return "No experiments run yet."
output = f"📊 **Experiment Log** ({len(ech0_prime.experiment_log)} experiments)\n\n"
for i, exp in enumerate(ech0_prime.experiment_log, 1):
exp_data = exp['experiment']
output += f"**{i}. {exp_data.get('lab')}** - {exp_data.get('experiment_type')}\n"
output += f" Timestamp: {exp.get('timestamp', 'N/A')}\n"
if 'error' in exp['results']:
output += f" ❌ Error: {exp['results']['error']}\n"
else:
output += f" ✅ Success\n"
output += "\n"
return output
except Exception as e:
return f"❌ Failed to get log: {str(e)}"
def reset_session() -> str:
"""Reset the ECH0-PRIME session"""
if not ech0_prime:
return "❌ ECH0-PRIME not available"
try:
# Save current session before reset
if ech0_prime.experiment_log or ech0_prime.conversation_history:
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
output_dir = get_output_dir()
filepath = os.path.join(output_dir, f"ech0_session_backup_{timestamp}.json")
ech0_prime.save_session(filepath)
backup_msg = f"\n✅ Previous session backed up to: `{filepath}`"
else:
backup_msg = ""
# Reset
ech0_prime.conversation_history = []
ech0_prime.experiment_log = []
return f"🔄 **Session Reset**\n\nConversation history and experiment log cleared.{backup_msg}"
except Exception as e:
return f"❌ Reset failed: {str(e)}"
# Create the Gradio interface
def create_interface():
"""Create the ECH0-PRIME Gradio API interface"""
with gr.Blocks(title="ECH0-PRIME × QuLab Infinite API",
theme=gr.themes.Soft()) as interface:
gr.Markdown("""
# 🤖 ECH0-PRIME × QuLab Infinite
## Autonomous Scientific Research Agent API
**ECH0-PRIME** (Kimi-K2 1046B) connected to **QuLab Infinite** with 1,532+ scientific tools across 220+ laboratories.
This API enables external LLMs to:
- Query ECH0-PRIME for scientific insights
- Run experiments on QuLab Infinite
- Navigate available labs and tools
- Start autonomous research sessions
""")
if ech0_error:
gr.Markdown(f"⚠️ **Warning**: ECH0-PRIME initialization failed: {ech0_error}")
with gr.Tabs():
# Overview Tab
with gr.TabItem("🏠 Overview"):
with gr.Row():
with gr.Column():
gr.Markdown("""
## 📊 System Capabilities
- **LLM**: Kimi-K2 1046B (Moonshot AI)
- **Labs**: 220+ specialized laboratories
- **Tools**: 1,532+ scientific tools
- **Domains**: Quantum, Biology, Chemistry, Physics, Medical, Environmental
## 🔗 API Endpoints
- `/query` - Ask scientific questions
- `/run_experiment` - Execute experiments
- `/list_labs` - Browse available labs
- `/research` - Start research session
- `/history` - View conversation history
- `/experiments` - View experiment log
""")
with gr.Column():
status_indicator = "🟢 **Fully Operational**" if ech0_prime else "🟡 **Limited Functionality**"
gr.Markdown(f"### System Status\n{status_indicator}")
# Lab list button
list_labs_btn = gr.Button("🔬 List Available Labs", variant="secondary")
labs_display = gr.Textbox(
label="Available Labs",
lines=15,
interactive=False
)
list_labs_btn.click(
fn=list_available_labs,
inputs=[],
outputs=labs_display,
api_name="list_labs"
)
# Query Tab
with gr.TabItem("💬 Query ECH0-PRIME"):
with gr.Row():
with gr.Column():
query_input = gr.Textbox(
label="🔍 Scientific Question",
placeholder="e.g., 'Design an experiment to test quantum teleportation fidelity at 100km'",
lines=3
)
include_context = gr.Checkbox(
label="Include conversation context",
value=True
)
query_btn = gr.Button("🤖 Ask ECH0-PRIME", variant="primary", size="lg")
with gr.Column():
query_output = gr.Textbox(
label="📝 Response",
lines=20,
interactive=False
)
query_btn.click(
fn=query_ech0_prime,
inputs=[query_input, include_context],
outputs=query_output,
api_name="query"
)
gr.Markdown("""
### 💡 Usage Tips
- Ask specific scientific questions
- Request experiment designs
- Get analysis of hypothetical scenarios
- ECH0-PRIME has full context of all previous queries in the session
""")
# Experiment Execution Tab
with gr.TabItem("🧪 Run Experiments"):
with gr.Row():
with gr.Column():
lab_name = gr.Textbox(
label="🔬 Lab Name",
placeholder="e.g., quantum_lab, oncology_lab",
lines=1
)
exp_type = gr.Textbox(
label="🧬 Experiment Type",
placeholder="e.g., teleportation_fidelity, tumor_evolution",
lines=1
)
exp_params = gr.Textbox(
label="⚙️ Parameters (JSON)",
placeholder='{"temperature": 25, "concentration": 0.1}',
lines=5
)
run_exp_btn = gr.Button("🚀 Run Experiment", variant="primary", size="lg")
with gr.Column():
exp_output = gr.Textbox(
label="📊 Experiment Results",
lines=20,
interactive=False
)
run_exp_btn.click(
fn=run_single_experiment,
inputs=[lab_name, exp_type, exp_params],
outputs=exp_output,
api_name="run_experiment"
)
gr.Markdown("""
### 📚 Example Experiments
**Quantum Lab**:
```json
Lab: quantum_lab
Type: teleportation_fidelity
Parameters: {"protocol": "GHZ", "num_qubits": 5, "distance_km": 100, "error_rate": 0.001}
```
**Oncology Lab**:
```json
Lab: oncology_lab
Type: tumor_evolution
Parameters: {"tumor_type": "NSCLC", "initial_size_mm": 15, "treatment": "pembrolizumab"}
```
""")
# Research Session Tab
with gr.TabItem("🔬 Research Sessions"):
with gr.Row():
with gr.Column():
research_q = gr.Textbox(
label="🎯 Research Question",
placeholder="e.g., 'What drug combinations are most effective for treating NSCLC with EGFR mutations?'",
lines=3
)
max_iter = gr.Slider(
minimum=1,
maximum=10,
value=5,
step=1,
label="Max Iterations"
)
research_btn = gr.Button("🔬 Start Research Session", variant="primary", size="lg")
with gr.Column():
research_output = gr.Textbox(
label="📊 Research Results",
lines=25,
interactive=False
)
research_btn.click(
fn=start_research_session,
inputs=[research_q, max_iter],
outputs=research_output,
api_name="research"
)
gr.Markdown("""
### 🔄 Autonomous Research Loop
ECH0-PRIME will:
1. Design experiments based on your question
2. Run them on QuLab Infinite
3. Analyze results
4. Iterate and refine
5. Provide final conclusions
This can take several minutes depending on complexity.
""")
# Session Management Tab
with gr.TabItem("📋 Session Management"):
with gr.Row():
with gr.Column():
gr.Markdown("### 💬 Conversation History")
history_btn = gr.Button("📜 View History", variant="secondary")
history_output = gr.Textbox(
label="Conversation History",
lines=15,
interactive=False
)
history_btn.click(
fn=get_conversation_history,
inputs=[],
outputs=history_output,
api_name="history"
)
with gr.Column():
gr.Markdown("### 📊 Experiment Log")
log_btn = gr.Button("📋 View Log", variant="secondary")
log_output = gr.Textbox(
label="Experiment Log",
lines=15,
interactive=False
)
log_btn.click(
fn=get_experiment_log,
inputs=[],
outputs=log_output,
api_name="experiments"
)
with gr.Row():
reset_btn = gr.Button("🔄 Reset Session", variant="stop")
reset_output = gr.Textbox(
label="Reset Status",
lines=3,
interactive=False
)
reset_btn.click(
fn=reset_session,
inputs=[],
outputs=reset_output,
api_name="reset"
)
return interface
# Launch the interface
if __name__ == "__main__":
interface = create_interface()
interface.launch(
server_name="0.0.0.0",
server_port=7861, # Different port from main QuLab GUI
show_api=True, # Enable Gradio API for external LLMs
share=False
)