# adk-redis examples

```json metadata
{
  "title": "adk-redis examples",
  "description": "Complete examples for every adk-redis capability.",
  "categories": ["docs","integrate","oss","rs","rc"],
  "group": "ai",
  "tableOfContents": {"sections":[{"id":"prerequisites","title":"Prerequisites"},{"id":"simpleredismemory","title":"simpleredismemory"},{"id":"travelagentmemoryhybrid","title":"travelagentmemory_hybrid"},{"id":"travelagentmemorytools","title":"travelagentmemory_tools"},{"id":"fitnesscoachmcp","title":"fitnesscoachmcp"},{"id":"redissearchtools","title":"redissearchtools"},{"id":"semanticcache","title":"semantic_cache"},{"id":"langcachecache","title":"langcache_cache"},{"id":"running-an-example","title":"Running an example"},{"id":"more-info","title":"More info"}]}

,
  "codeExamples": []
}
```
The [adk-redis repository](https://github.com/redis-developer/adk-redis/tree/main/examples) includes seven complete examples. Each focuses on a specific capability.

## Prerequisites

All examples require:

- **Python 3.10+**
- **Redis 8.4+**: `docker run -d --name redis -p 6379:6379 redis:8.4-alpine`
- **Agent Memory Server** (for memory examples): See [setup instructions](https://github.com/redis/agent-memory-server)
- **API keys**: Most examples need a `GOOGLE_API_KEY` for Gemini

## `simple_redis_memory`

**Capability:** Redis Agent Memory (framework-managed)

Minimal starting point. Wires up `RedisWorkingMemorySessionService` and `RedisLongTermMemoryService` with a basic conversational agent. No search tools, no caching: just memory.

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/simple_redis_memory)

## `travel_agent_memory_hybrid`

**Capability:** Redis Agent Memory + REST tools + web search + planning

The most complete example. Combines framework-managed memory services with LLM-controlled memory tools, web search, itinerary planning, and calendar export. Demonstrates the [hybrid integration pattern]().

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/travel_agent_memory_hybrid)

## `travel_agent_memory_tools`

**Capability:** REST memory tools (LLM-controlled)

Uses REST-based memory tools exclusively, without framework-managed services. The LLM has full control over when to search, create, update, and delete memories.

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/travel_agent_memory_tools)

## `fitness_coach_mcp`

**Capability:** MCP memory tools

Demonstrates MCP-based memory integration. The agent connects to the Agent Memory Server via SSE and manages semantic and episodic memories for workout tracking.

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/fitness_coach_mcp)

## `redis_search_tools`

**Capability:** Vector, hybrid, text, and range search

All four RedisVL [search tools]() plugged into a single agent with a product catalog dataset.

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/redis_search_tools)

## `semantic_cache`

**Capability:** Local semantic caching (RedisVL)

Demonstrates LLM response caching and tool result caching using the `RedisVLCacheProvider` with local embeddings and ADK callbacks.

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/semantic_cache)

## `langcache_cache`

**Capability:** Managed semantic caching (LangCache)

Uses the managed [LangCache]() service for semantic caching with server-side embeddings. No local vectorizer required.

[View on GitHub](https://github.com/redis-developer/adk-redis/tree/main/examples/langcache_cache)

## Running an example

```bash
pip install adk-redis[all]
cd examples/simple_redis_memory
export GOOGLE_API_KEY=your-key
python main.py
```

## More info

- [Car dealership tutorial](https://redis.io/tutorials/build-a-car-dealership-agent-with-google-adk-and-redis-agent-memory/): Full walkthrough building an agent from scratch
- [adk-redis README](https://github.com/redis-developer/adk-redis): Installation and overview