Future AGI SDKs: Python, TypeScript, Java, and C#

Evaluate LLM outputs, trace AI calls, optimize prompts, and test voice agents. Python, TypeScript, Java, and C# supported.

📝
TL;DR
  • Python: evals, tracing, datasets, prompts, optimization, simulation
  • TypeScript: evals, tracing, datasets, prompts
  • Java / C#: tracing
  • pip install ai-evaluation or npm install @future-agi/ai-evaluation to get started

Future AGI is a set of packages that evaluate LLM outputs, trace calls across your stack, optimize prompts, and load-test voice agents. Install what you need, skip what you don’t.

Language Support

ModulePythonTypeScriptJavaC#
EvaluationsFullFull
TracingFull (45+)Full (40+)Full (25+)Full
DatasetsFullFull
PromptsFullFull
Prompt OptimizationFull
SimulationFull

Quickstart

pip install ai-evaluation

Requires Python 3.10+. This also installs futureagi (datasets, prompts, knowledge bases) automatically.

export FI_API_KEY="your-api-key"
export FI_SECRET_KEY="your-secret-key"
from fi.evals import evaluate

# Local metric — no API key needed
result = evaluate("contains", output="Hello world", keyword="Hello")
print(result.score)    # 1.0
print(result.passed)   # True

# Cloud metric — needs FI_API_KEY and FI_SECRET_KEY
result = evaluate("toxicity", output="Hello world", model="turing_flash")
print(result.score)    # 1.0
print(result.passed)   # True

Want tracing too? Add the instrumentor for your provider:

pip install fi-instrumentation-otel traceai-openai
npm install @future-agi/ai-evaluation
export FI_API_KEY="your-api-key"
export FI_SECRET_KEY="your-secret-key"
import { Evaluator, Tone } from "@future-agi/ai-evaluation";

const evaluator = new Evaluator();

const result = await evaluator.evaluate({
  evalTemplates: [new Tone()],
  inputs: [{
    query: "Write a professional email",
    response: "Dear Sir/Madam, I hope this message finds you well..."
  }],
  modelName: "turing_flash"
});

console.log(result);

Want tracing too?

npm install @traceai/fi-core @traceai/openai

Java support covers tracing only. 25+ instrumentors including Spring AI and LangChain4j.

<!-- Maven — add the JitPack repository -->
<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.future-agi.traceAI</groupId>
    <artifactId>traceai-java-openai</artifactId>
    <version>LATEST</version>
</dependency>

See the Tracing docs for setup instructions.

C# support covers tracing only.

dotnet add package fi-instrumentation-otel

See the Tracing docs for setup instructions.

Getting an error? Check these common issues

ModuleNotFoundError: No module named 'fi' — The package is called ai-evaluation, not future-agi or futureagi-sdk:

pip install ai-evaluation

AuthenticationError — Both FI_API_KEY and FI_SECRET_KEY must be set. The API key alone is not enough.

Python version errorai-evaluation requires Python 3.10+. Check with python --version.

Packages

Python

Six packages, each installable independently:

PackageInstallWhat it doesPython
futureagipip install futureagiDatasets, prompt versioning, knowledge bases3.9+
ai-evaluationpip install ai-evaluation76+ local metrics + 100+ cloud templates, guardrails, streaming eval3.10+
fi-instrumentation-otelpip install fi-instrumentation-otelOpenTelemetry tracing for AI apps3.9+
traceai-*pip install traceai-openaiAuto-instrumentation for 45+ frameworks3.9+
agent-optpip install agent-optPrompt optimization (6 algorithms)3.10+
agent-simulatepip install agent-simulateSimulate voice AI agents at scale3.10+
futureagi                    ← standalone base layer
  └── ai-evaluation          ← installs futureagi automatically
        └── agent-opt        ← installs ai-evaluation automatically

fi-instrumentation-otel      ← standalone tracing layer
  ├── traceai-*              ← each installs fi-instrumentation-otel
  └── agent-simulate         ← installs fi-instrumentation-otel

Tip

You don’t need to install dependencies manually. pip install ai-evaluation gives you futureagi too. pip install traceai-openai gives you fi-instrumentation-otel too.

TypeScript

PackageInstallWhat it does
@future-agi/sdknpm install @future-agi/sdkDatasets, prompt versioning, knowledge bases
@future-agi/ai-evaluationnpm install @future-agi/ai-evaluationEval metrics and guardrails
@traceai/fi-corenpm install @traceai/fi-coreTracing core
@traceai/openainpm install @traceai/openaiFramework instrumentors (40+)

Java and C#

Tracing only. Java has 25+ instrumentors (Maven via JitPack, group ID com.github.future-agi.traceAI). C# has a single NuGet package (fi-instrumentation-otel). See the Tracing reference for details.

List of SDKs

Each SDK installs independently. Pick the ones you need and follow its reference for the full API.

Was this page helpful?

Questions & Discussion