Aleph-10 logo

Aleph-10

by bjkemp

Aleph-10 is a Model Context Protocol (MCP) server that combines weather data services with vector-based memory storage. It provides tools for retrieving weather information and managing semantic memory through vector embeddings.

View on GitHub

Last updated: N/A

What is Aleph-10?

Aleph-10 is a Model Context Protocol (MCP) server designed to integrate weather data services with vector memory capabilities. It allows users to retrieve weather alerts and forecasts while also storing and retrieving information using semantic search powered by vector embeddings.

How to use Aleph-10?

To use Aleph-10, first clone the repository, install dependencies using pnpm, configure environment variables (including API keys for embedding providers), build the project, and then run the server. Once running, you can use the provided tools (get-alerts, get-forecast, memory-store, memory-retrieve, etc.) by sending requests to the server according to the Model Context Protocol.

Key features of Aleph-10

  • Weather Information: Retrieve weather alerts and forecasts using the National Weather Service API.

  • Vector Memory: Store and retrieve information using semantic search.

  • Multiple Embedding Options: Supports cloud-based (Google Gemini) and local (Ollama) embedding providers.

  • Metadata Support: Add and filter by metadata for efficient memory management.

Use cases of Aleph-10

  • Building AI assistants that can provide weather updates and remember user preferences.

  • Creating knowledge bases that combine factual information with semantic understanding.

  • Developing applications that require both real-time data and long-term memory.

  • Implementing context-aware systems that adapt to changing environments and user needs.

FAQ from Aleph-10

What embedding providers are supported?

Aleph-10 supports Google Gemini (cloud-based) and Ollama (local) for generating vector embeddings.

How do I configure the embedding provider?

You can configure the embedding provider using the EMBEDDING_PROVIDER environment variable. Set it to gemini or ollama.

Where is the vector database stored?

The vector database is stored in the location specified by the VECTOR_DB_PATH environment variable. The default is ./data/vector_db.

How do I run the tests?

Use the command pnpm test to run the tests once, pnpm test:watch to run in watch mode, or pnpm test:ui to run with a UI.

What license is Aleph-10 released under?

This project is licensed under the ISC License.