GithubHelp home page GithubHelp logo

zook111 / langtrace Goto Github PK

View Code? Open in Web Editor NEW

This project forked from scale3-labs/langtrace

0.0 0.0 0.0 1.44 MB

Langtrace ๐Ÿ” is an open-source, Open Telemetry based end-to-end observability tool for LLM applications, providing real-time tracing, evaluations and metrics for popular LLMs, LLM frameworks, vectorDBs and more.. Integrate using Typescript, Python. ๐Ÿš€๐Ÿ’ป๐Ÿ“Š

Home Page: https://langtrace.ai

License: GNU Affero General Public License v3.0

JavaScript 0.06% TypeScript 99.55% CSS 0.28% Dockerfile 0.11%

langtrace's Introduction

Open Source Observability for LLM applications

Open Source & Open Telemetry(OTEL) Observability for LLM applications

Static Badge NPM Typescript SDK PyPI Python SDK Downloads NPM Trace Attributes PyPI Trace Attributes Static Badge Deploy on Railway


Langtrace is an open source observability software which lets you capture, debug and analyze traces and metrics from all your applications that leverages LLM APIs, Vector Databases and LLM based Frameworks.

image

Open Telemetry Support

The traces generated by Langtrace adhere to Open Telemetry Standards(OTEL). We are developing semantic conventions for the traces generated by this project. You can checkout the current definitions in this repository. Note: This is an ongoing development and we encourage you to get involved and welcome your feedback.


SDK Repositories


Getting Started

Langtrace Cloud โ˜๏ธ

To use the managed SaaS version of Langtrace, follow the steps below:

  1. Sign up by going to this link.
  2. Create a new Project after signing up. Projects are containers for storing traces and metrics generated by your application. If you have only one application, creating 1 project will do.
  3. Generate an API key by going inside the project.
  4. In your application, install the Langtrace SDK and initialize it with the API key you generated in the step 3.
  5. The code for installing and setting up the SDK is shown below:

If your application is built using typescript/javascript

npm i @langtrase/typescript-sdk
import * as Langtrace from '@langtrase/typescript-sdk' // Must precede any llm module imports
Langtrace.init({ api_key: <your_api_key> })

OR

import * as Langtrace from "@langtrase/typescript-sdk"; // Must precede any llm module imports
LangTrace.init(); // LANGTRACE_API_KEY as an ENVIRONMENT variable

If your application is built using python

pip install langtrace-python-sdk
from langtrace_python_sdk import langtrace
langtrace.init(api_key=<your_api_key>)

OR

from langtrace_python_sdk import langtrace
langtrace.init() # LANGTRACE_API_KEY as an ENVIRONMENT variable

Langtrace self hosted

To run the Langtrace locally, you have to run three services:

  • Next.js app
  • Postgres database
  • Clickhouse database

Important

Checkout our documentation for various deployment options and configurations.

Requirements:

  • Docker
  • Docker Compose

The .env file

Feel free to modify the .env file to suit your needs.

Starting the servers

docker compose up

The application will be available at http://localhost:3000.

Take down the setup

To delete containers and volumes

docker compose down -v

-v flag is used to delete volumes


Supported integrations

Langtrace automatically captures traces from the following vendors:

Vendor Type Typescript SDK Python SDK
OpenAI LLM โœ… โœ…
Anthropic LLM โœ… โœ…
Azure OpenAI LLM โœ… โœ…
Cohere LLM โœ… โœ…
Groq LLM โŒ โœ…
Perplexity LLM โœ… โœ…
Langchain Framework โŒ โœ…
LlamaIndex Framework โœ… โœ…
Langgraph Framework โŒ โœ…
DSPy Framework โŒ โœ…
CrewAI Framework โŒ โœ…
Ollama Framework โŒ โœ…
Pinecone Vector Database โœ… โœ…
ChromaDB Vector Database โœ… โœ…
QDrant Vector Database โœ… โœ…
Weaviate Vector Database โœ… โœ…
PGVector Vector Database โœ… โœ… (SQLAlchemy)

Langtrace System Architecture

image


Feature Requests and Issues


Contributions

We welcome contributions to this project. To get started, fork this repository and start developing. To get involved, join our Slack workspace.


Langtrace Star History

Langtrace Star History Chart


Security

To report security vulnerabilites, email us at [email protected]. You can read more on security here.


License

  • Langtrace application(this repository) is licensed under the AGPL 3.0 License. You can read about this license here.
  • Langtrace SDKs are licensed under the Apache 2.0 License. You can read about this license here.

Frequently Asked Questions

1. Can I self host and run Langtrace in my own cloud? Yes, you can absolutely do that. Follow the self hosting setup instructions in our documentation.

2. What is the pricing for Langtrace cloud? Currently, we are not charging anything for Langtrace cloud and we are primarily looking for feedback so we can continue to improve the project. We will inform our users when we decide to monetize it.

3. What is the tech stack of Langtrace? Langtrace uses NextJS for the frontend and APIs. It uses PostgresDB as a metadata store and Clickhouse DB for storing spans, metrics, logs and traces.

4. Can I contribute to this project? Absolutely! We love developers and welcome contributions. Get involved early by joining our Discord Community.

5. What skillset is required to contribute to this project? Programming Languages: Typescript and Python. Framework knowledge: NextJS. Database: Postgres and Prisma ORM. Nice to haves: Opentelemetry instrumentation framework, experience with distributed tracing.

langtrace's People

Contributors

karthikscale3 avatar dylanzuber-scale3 avatar yemiadej avatar rohit-kadhe avatar darshit-s3 avatar alizenhom avatar dependabot[bot] avatar cruppelt avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.