Relace Templates

If you have a base repo as a starting point for your agent, it’s recommended to turn it into a template Relace repo.

Make a Template Repo

Create a Relace repo from your base codebase and save the repo_id:

import { Relace } from "@relace-ai/relace";

const client = new Relace({ apiKey: "YOUR_API_KEY" });

const templateRepo = await client.repo.create({
    source: {
        type: "git",
        url: "https://github.com/relace-ai/vite-template",
        branch: "main"
    }
});

const templateRepoId = templateRepo.repo_id;
console.log(`Template repository created with ID: ${templateRepoId}`);

import { Relace } from "@relace-ai/relace";

const client = new Relace({ apiKey: "YOUR_API_KEY" });

const templateRepo = await client.repo.create({
    source: {
        type: "files",
        files: [
            {
                filename: "src/agent.py",
                content: "class Agent:\n    def __init__(self):\n        self.name = 'BaseAgent'\n    \n    def process(self, input_data):\n        # Base processing logic\n        return input_data"
            },
            // Add more template files as needed
        ]
    }
});

const templateRepoId = templateRepo.repo_id;
console.log(`Template repository created with ID: ${templateRepoId}`);

Create Repo from Relace Template

Now you can use the saved template_repo_id to quickly create new Relace repos:

import { Relace } from "@relace-ai/relace";

const client = new Relace({ apiKey: "YOUR_API_KEY" });

const newRepo = await client.repo.create({
    source: {
        type: "relace",
        repo_id: templateRepoId,
    },
    metadata: {} // Optional: add any custom properties
});

console.log(`New repository created with ID: ${newRepo.repo_id}`);

Repo creation with a Relace template is nearly instantaneous, as you no longer pay the latency cost of transferring these base files over the network.

⌘I

Getting Started

Model Guides

Repos

Agents

Relace Templates