Projects API

import requests
import base64

API_KEY = "your_api_key_here"
BASE_URL = "https://explorableresearch.com"

headers = {
    "x-api-key": API_KEY,
    "Content-Type": "application/json"
}

# Create a project from an ArXiv paper (synchronous - waits for completion)
response = requests.post(
    f"{BASE_URL}/api/v1/projects/create",
    headers=headers,
    json={
        "arxiv_url": "https://arxiv.org/abs/2301.00001",
        "instruction": "Focus on visualizing the key algorithm"
    },
    timeout=300  # 5 minute timeout for AI generation
)
project = response.json()["project"]
print(f"Created project: {project['id']}")
print(f"Preview URL: {project['preview_url']}")

# Get full project details including code
response = requests.get(
    f"{BASE_URL}/api/projects/{project['id']}",
    headers=headers
)
full_project = response.json()["project"]
print(f"Code: {full_project['fragment']['code'][:100]}...")

# Continue the project with new instructions (synchronous)
response = requests.post(
    f"{BASE_URL}/api/v1/projects/{project['id']}/continue",
    headers=headers,
    json={"instruction": "Add a slider to control parameters"},
    timeout=300
)
updated_project = response.json()["project"]
print(f"Updated preview: {updated_project['preview_url']}")

# Create from local PDF
with open("paper.pdf", "rb") as f:
    pdf_base64 = base64.b64encode(f.read()).decode()

response = requests.post(
    f"{BASE_URL}/api/v1/projects/create",
    headers=headers,
    json={
        "pdf_file": pdf_base64,
        "pdf_filename": "paper.pdf",
        "template": "html-developer",  # Use static HTML template
        "instruction": "Create an interactive explanation"
    },
    timeout=300
)
html_project = response.json()["project"]
print(f"HTML project: {html_project['preview_url']}")

const API_KEY = "your_api_key_here";
const BASE_URL = "https://explorableresearch.com";

const headers = {
  "x-api-key": API_KEY,
  "Content-Type": "application/json",
};

// Create a project from an ArXiv paper (synchronous)
async function createFromArxiv(arxivUrl: string, instruction?: string) {
  const response = await fetch(`${BASE_URL}/api/v1/projects/create`, {
    method: "POST",
    headers,
    body: JSON.stringify({ arxiv_url: arxivUrl, instruction }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error?.message || "Failed to create project");
  }

  const { project } = await response.json();
  console.log(`Created project: ${project.id}`);
  console.log(`Preview: ${project.preview_url}`);
  return project;
}

// Get full project details
async function getProject(projectId: string) {
  const response = await fetch(`${BASE_URL}/api/projects/${projectId}`, {
    headers: { "x-api-key": API_KEY },
  });
  return response.json();
}

// Continue an existing project (synchronous)
async function continueProject(projectId: string, instruction: string) {
  const response = await fetch(
    `${BASE_URL}/api/v1/projects/${projectId}/continue`,
    {
      method: "POST",
      headers,
      body: JSON.stringify({ instruction }),
    }
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error?.message || "Failed to continue project");
  }

  return response.json();
}

// List all projects
async function listProjects() {
  const response = await fetch(`${BASE_URL}/api/projects`, {
    headers: { "x-api-key": API_KEY },
  });
  return response.json();
}

// Example usage
const project = await createFromArxiv(
  "https://arxiv.org/abs/1706.03762",
  "Visualize the Transformer attention mechanism"
);

const updated = await continueProject(
  project.id,
  "Add an interactive slider to control the number of attention heads"
);
console.log(`Updated: ${updated.project.preview_url}`);