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.
- Python: evals, tracing, datasets, prompts, optimization, simulation
- TypeScript: evals, tracing, datasets, prompts
- Java / C#: tracing
pip install ai-evaluationornpm install @future-agi/ai-evaluationto 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
| Module | Python | TypeScript | Java | C# |
|---|---|---|---|---|
| Evaluations | Full | Full | — | — |
| Tracing | Full (45+) | Full (40+) | Full (25+) | Full |
| Datasets | Full | Full | — | — |
| Prompts | Full | Full | — | — |
| Prompt Optimization | Full | — | — | — |
| Simulation | Full | — | — | — |
Quickstart
pip install ai-evaluationRequires 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) # TrueWant tracing too? Add the instrumentor for your provider:
pip install fi-instrumentation-otel traceai-openai npm install @future-agi/ai-evaluationexport 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-otelSee 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-evaluationAuthenticationError — Both FI_API_KEY and FI_SECRET_KEY must be set. The API key alone is not enough.
Python version error — ai-evaluation requires Python 3.10+. Check with python --version.
Packages
Python
Six packages, each installable independently:
| Package | Install | What it does | Python |
|---|---|---|---|
| futureagi | pip install futureagi | Datasets, prompt versioning, knowledge bases | 3.9+ |
| ai-evaluation | pip install ai-evaluation | 76+ local metrics + 100+ cloud templates, guardrails, streaming eval | 3.10+ |
| fi-instrumentation-otel | pip install fi-instrumentation-otel | OpenTelemetry tracing for AI apps | 3.9+ |
| traceai-* | pip install traceai-openai | Auto-instrumentation for 45+ frameworks | 3.9+ |
| agent-opt | pip install agent-opt | Prompt optimization (6 algorithms) | 3.10+ |
| agent-simulate | pip install agent-simulate | Simulate voice AI agents at scale | 3.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
| Package | Install | What it does |
|---|---|---|
| @future-agi/sdk | npm install @future-agi/sdk | Datasets, prompt versioning, knowledge bases |
| @future-agi/ai-evaluation | npm install @future-agi/ai-evaluation | Eval metrics and guardrails |
| @traceai/fi-core | npm install @traceai/fi-core | Tracing core |
| @traceai/openai | npm install @traceai/openai | Framework 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.
Evaluation
76+ local metrics for tone, hallucination, bias, and factual accuracy, plus guardrails that run in under 10ms.
TraceAI
Auto-instrument 45+ frameworks or add custom spans. LLM calls, retrieval, and agent actions stream to your dashboard.
Core SDKs
Datasets, Prompt Optimization, Simulation, Knowledge Base, and Protect. Install and quick start for each.
Questions & Discussion