FAQ

Is user data isolated from other users? How does multi-tenancy work?

Yes, Zep provides full multi-tenant isolation. All graphs—whether user graphs or standalone graphs—are completely isolated from each other with no shared state.

• User graphs: When you call thread.get_user_context(), it retrieves context only from that user’s graph. Other users’ data is never accessible.
• Standalone graphs: Each standalone graph is independent and isolated from other graphs.
• Access management: You control which graphs your application accesses by specifying user_id or graph_id in API calls.

To share context across users, create a standalone graph and query it explicitly. The sharing context cookbook provides an example.

How well does Zep scale?

Account capacity, request rates, and processing concurrency depend on your plan. Read the rate limits and contact Zep for workload-specific capacity requirements.

Can I self host Zep? What happened to Zep Community Edition?

Zep Community Edition, which allows you to host Zep locally, is deprecated and no longer supported. See our announcement post here.

The alternatives we offer include:

• Zep Cloud: Our hosted solution
• Graphiti: The open-source Context Graph framework that powers Zep Cloud
• BYOC (Bring Your Own Cloud): For enterprise customers who need VPC residency and maximum control, we offer BYOC deployments where Zep runs in your own cloud infrastructure. Contact our Enterprise team to learn more.

Is there a limit on the number of graphs I can create?

Zep does not configure a fixed graph-count limit. API and ingestion limits still apply to graph creation and updates.

Is there a limit on the size of the graph?

Zep does not configure a fixed graph-size limit. Payload, request-rate, and processing-concurrency limits still apply.

What’s the difference between Zep and Graphiti?

Read the Zep and Graphiti comparison.

Does Zep Cloud support multiple spoken languages?

We have official multilingual support on our roadmap, enabling the creation of graphs in a user’s own language. Currently, graphs are not explicitly created in the user’s language. However, Zep should work well today with any language, provided you’re using a multilingual LLM and your own prompts explicitly state that responses to the user should be in their language.

Is there a free version of Zep Cloud?

Yes - Zep offers a free tier. See Pricing for more information.

How do I access previous billing statements?

Open the billing page in the Zep dashboard. On a paid plan, click Open Billing Portal to view and download invoices.

For Enterprise invoices, contact [email protected].

How do I update billing information such as a tax ID or VAT number?

Use the billing portal to update your company name, billing address, and tax ID or VAT number.

1. Open the billing page in the Zep dashboard.
2. Click Open Billing Portal.
3. Update the billing details in the portal.

For Enterprise billing details, contact [email protected].

Can I use Zep to replace RAG over static documents?

Zep can be used for retrieval for static documents just like RAG or GraphRAG, although this is not what Zep was designed for. Zep was designed for dynamic, changing data, which RAG and GraphRAG were not designed to do.

How does thread.get_user_context retrieve context?

thread.get_user_context uses the four most recent messages as an auto-search query. Auto search retrieves candidates from the user graph and selects context within a character budget.

The Context Block can contain facts, entities, episodes, observations, thread summaries, and a user summary. Read Retrieving context for details.

What is the API URL for Zep Cloud?

The API URL for Zep Cloud is https://api.getzep.com. Note that you do not need to specify the API URL when using the Cloud SDKs. If a service requests the Zep URL, it is possible it’s only compatible with the Zep Community Edition service.

Should I use nodes, edges, or episodes when searching the graph and creating a context string?

You can use any combination of nodes, edges, and episodes. There is not a one size fits all solution, and you will likely need to experiment with different approaches to get the best performance for your use case.

How do I add messages or manage context for a group chat with multiple people?

Use graph.add with type="message" to add group-chat messages to a standalone graph. Do not use thread.add_messages, because a thread belongs to one user.

Search the standalone graph and construct a Context Block from the results.

Does Zep handle emojis? Should I convert them to unicode characters before adding them to Zep?

Yes. Send emojis as Unicode characters. Do not encode them before ingestion.

I am seeing information duplicated between different node summaries. Is this normal?

This is a normal and intended feature of Zep. Node summaries are intended to be standalone summaries of the node, which often means describing the relationships that that node has to other nodes. Those same relationships are likely to appear in the summaries of those other nodes.

Why aren’t my episodes processing?

Episode ingestion is asynchronous. Multiple episodes for one graph can wait for earlier episodes to finish.

Please confirm the following:

• Have you exhausted your episode credits? If you’re on the free tier, you have a limited number of episode credits per month. Once depleted, episodes will stop processing until the next billing cycle or until you upgrade to a paid plan. Check your usage in the Zep dashboard and see our Pricing page for plan options.
• If you submitted multiple episodes, use the returned task IDs to check ingestion status.
• If neither of the above applies, reach out to our support team at [email protected] and let them know what you are seeing.

How do I get the playground to work with my own data?

The playground uses demo data and does not accept custom data. Use a Zep SDK to create a graph with your data.

The quick start guide provides an example.

I can’t join my company project, because I have already created an account. What should I do?

You will need to delete your account and then accept the invitation from your company.

How do I get Zep to work with n8n?

The Zep n8n integration is no longer supported. Use a Zep SDK instead.