Memovee Tama

This repository contains the Terraform configuration for the Memovee Tama application, which provides a comprehensive AI-powered conversational platform integrating with various services including Tama, Mistral, X.ai, and Elasticsearch. The system supports advanced features like personalized conversations, media handling, and intelligent message routing.

Table of Contents

• Overview
• Core Components
• Architecture
• Key Modules
• Space Relationships
• Documentation
• Getting Started

Overview

The Memovee Tama system is designed to create an intelligent conversational AI platform that can handle:

• Personalized conversations with user profiles
• Media-related interactions
• Message routing and classification
• Contextual awareness and memory
• Integration with external AI services

Core Components

Main Module

• Core memovee messaging module serving as the primary interface
• Reply generation chain with associated processors
• Configuration for handling reply generation with specific models and contexts

Models

All models referenced via *_model_id, *_model_parameters, and tama_thought_processor resources:

Function	Model	Temperature	Reasoning effort	Service tier
Memovee - Reply Generation	gpt-5-mini	1.0	low
Router - Message Routing	gpt-5-mini	1.0	minimal
Elasticsearch - Index Mapping Generation	gpt-5	1.0	low
Index Definition Generation	gpt-5	1.0	low
Movie DB - Generate Description	gpt-5-nano	1.0	low	flex
Movie DB - Generate Setting	gpt-5-nano	1.0	low	flex
Media Browsing - Tool Call	gpt-5-mini	1.0	minimal
Media Detail - Tool Call	gpt-5	1.0	minimal
Person Browsing - Tool Call	gpt-5-mini	1.0	minimal
Person Detail - Tool Call	gpt-5	1.0	minimal
Memovee - Artifact Creation	gpt-5-mini	1.0	low
Basic - Check Profile Tooling	gpt-5	1.0	minimal
Basic - Upsert Profile Tooling	gpt-5	1.0	minimal

Data Storage

• Elasticsearch module for indexing and searching capabilities
• Personalization and prompt assembly spaces

Architecture

The system is built with a modular architecture that allows for flexible extension and maintenance of different conversational functionalities.

Key Modules

• Main: Core memovee functionality and interfaces
• Basic: Basic conversation handling with off-topic, greeting, and introductory flows
• Media: Media-related conversation components
• Personalization: User-specific content management
• Prompt Assembly: Contextual information assembly
• Router: Message classification and routing
• Movie Database: Movie information integration

Space Relationships

The following diagram shows the correct relationships between Tama spaces in the system, based on the actual tama_space_bridge resource definitions:

graph LR
    A[Main Memovee Space]
    B[Basic Conversation Space]
    C[Media Conversation Space]
    F[Movie DB Space]
    G[Elasticsearch Space]
    H[Memovee UI Space]
    A -- "memovee-basic" --> B
    A -- "memovee-media" --> C
    A -- "memovee-ui" --> H
    B -- "basic-conversation-memovee-ui" --> H
    B -- "basic-conversation-memovee" --> A
    C -- "media-conversation-to-movie-db" --> F
    C -- "media-conversation-to-memovee-ui" --> H
    C -- "media-conversation-to-memovee" --> A
    F -- "movie-db-elasticsearch" --> G
    style A fill:#bbdefb stroke:#333
    style B fill:#c8e6c9 stroke:#333
    style C fill:#ffe0b2 stroke:#333
    style F fill:#d7ccc8 stroke:#333
    style G fill:#fff9c4 stroke:#333
    style H fill:#cfd8dc stroke:#333

Loading

Documentation

For detailed information about the various components of the Memovee Tama system, please refer to the following documentation files:

• Main Module Documentation
• Movie Database Documentation
• Personalization Documentation
• Router Module Documentation

Getting Started

To get started with the Memovee Tama project, you'll need to:

1. Set up your environment with the required Terraform version (v1.0.0+)
2. Configure API keys for external services (Tama, Mistral, X.ai, Elasticsearch)
3. Create a .auto.tfvars file with your configuration values
4. Run terraform init, terraform plan, and terraform apply

Requirements

Name	Version
terraform	>= 1.0.0
tama	~> 0.4

Providers

Name	Version
http	3.5.0
tama	0.5.1

Modules

Name	Source	Version
anthropic	upmaru/base/tama//modules/inference-service	0.4.9
artifact-context	upmaru/base/tama//modules/thought-context	0.4.9
check-profile-tooling	upmaru/base/tama//modules/tooling	0.4.9
curse	upmaru/base/tama//modules/forwardable-class	0.4.9
elasticsearch	upmaru/base/tama//modules/elasticsearch	0.4.9
global	upmaru/base/tama	0.4.9
greeting	upmaru/base/tama//modules/forwardable-class	0.4.9
index-definition-generation	./modules/index-definition	n/a
index-mapping-generation	./modules/index-mapping	n/a
introductory	upmaru/base/tama//modules/forwardable-class	0.4.9
manage-record-markings	upmaru/base/tama//modules/tooling	0.4.9
manipulation	upmaru/base/tama//modules/forwardable-class	0.4.9
marking	upmaru/base/tama//modules/forwardable-class	0.4.9
memovee	upmaru/base/tama//modules/messaging	0.4.9
mistral	upmaru/base/tama//modules/inference-service	0.4.9
movie-browsing	./modules/media-conversate	n/a
movie-browsing-forwardable	upmaru/base/tama//modules/forwardable-class	0.4.9
movie-db	./modules/movie-db	n/a
movie-detail	./modules/media-conversate	n/a
movie-detail-forwardable	upmaru/base/tama//modules/forwardable-class	0.4.9
off-topic	upmaru/base/tama//modules/forwardable-class	0.4.9
openai	upmaru/base/tama//modules/inference-service	0.4.9
patch	upmaru/base/tama//modules/forwardable-class	0.4.9
person-browsing	./modules/media-conversate	n/a
person-browsing-forwardable	upmaru/base/tama//modules/forwardable-class	0.4.9
person-detail	./modules/media-conversate	n/a
person-detail-forwardable	upmaru/base/tama//modules/forwardable-class	0.4.9
personalization	upmaru/base/tama//modules/forwardable-class	0.4.9
reply-context	upmaru/base/tama//modules/thought-context	0.4.9
router	upmaru/base/tama//modules/router	0.4.9
update-user-perference	upmaru/base/tama//modules/tooling	0.4.9
upsert-profile-tooling	upmaru/base/tama//modules/tooling	0.4.9
voyageai	upmaru/base/tama//modules/inference-service	0.4.9
watch-providers	./modules/watch-providers	n/a
xai	upmaru/base/tama//modules/inference-service	0.4.9

Resources

Name	Type
tama_chain.curse	resource
tama_chain.handle-marking	resource
tama_chain.handle-personalization	resource
tama_chain.load-profile-and-greet	resource
tama_chain.manipulation	resource
tama_chain.off-topic	resource
tama_chain.patch-reply	resource
tama_chain.reply-generation	resource
tama_chain.upsert-profile	resource
tama_listener.memovee-ui-listener	resource
tama_listener_filter.curse	resource
tama_listener_filter.load-profile-and-greet	resource
tama_listener_filter.manipulation	resource
tama_listener_filter.marking	resource
tama_listener_filter.movie-browsing	resource
tama_listener_filter.movie-detail	resource
tama_listener_filter.off-topic	resource
tama_listener_filter.patch-reply	resource
tama_listener_filter.person-browsing	resource
tama_listener_filter.person-detail	resource
tama_listener_filter.personalization	resource
tama_listener_filter.reply-generation	resource
tama_listener_filter.routing	resource
tama_listener_filter.upsert-profile	resource
tama_listener_topic.user-message-topic	resource
tama_modular_thought.forward-check-profile	resource
tama_modular_thought.forward-curse	resource
tama_modular_thought.forward-manipulation	resource
tama_modular_thought.forward-marking	resource
tama_modular_thought.forward-off-topic	resource
tama_modular_thought.forward-patch	resource
tama_modular_thought.forward-personalization	resource
tama_modular_thought.forward-upsert-profile	resource
tama_modular_thought.reply-artifact	resource
tama_modular_thought.reply-generation	resource
tama_node.handle-check-profile	resource
tama_node.handle-curse	resource
tama_node.handle-manipulation	resource
tama_node.handle-marking	resource
tama_node.handle-off-topic	resource
tama_node.handle-patch	resource
tama_node.handle-personalization	resource
tama_node.handle-reply-generation	resource
tama_node.handle-upsert-profile	resource
tama_prompt.check-profile-artifact	resource
tama_prompt.check-profile-reply	resource
tama_prompt.check-profile-tooling	resource
tama_prompt.curse-reply	resource
tama_prompt.handle-marking	resource
tama_prompt.handle-personalization	resource
tama_prompt.manipulation-reply	resource
tama_prompt.marking-artifact	resource
tama_prompt.marking-reply	resource
tama_prompt.marking-routing	resource
tama_prompt.memovee	resource
tama_prompt.movie-browsing-artifact	resource
tama_prompt.movie-browsing-reply	resource
tama_prompt.movie-browsing-tooling	resource
tama_prompt.movie-detail-artifact	resource
tama_prompt.movie-detail-reply	resource
tama_prompt.movie-detail-tooling	resource
tama_prompt.off-topic-reply	resource
tama_prompt.patch-artifact	resource
tama_prompt.patch-reply	resource
tama_prompt.person-browse-artifact	resource
tama_prompt.person-browse-reply	resource
tama_prompt.person-browse-tooling	resource
tama_prompt.person-detail-artifact	resource
tama_prompt.person-detail-reply	resource
tama_prompt.person-detail-tooling	resource
tama_prompt.personalization-artifact	resource
tama_prompt.personalization-reply	resource
tama_prompt.personalization-routing	resource
tama_prompt.reply-artifact	resource
tama_prompt.reply-template	resource
tama_prompt.upsert-profile-artifact	resource
tama_prompt.upsert-profile-reply	resource
tama_prompt.upsert-profile-tooling	resource
tama_source_identity.memovee-ui-oauth	resource
tama_space.basic-conversation	resource
tama_space.media-conversation	resource
tama_space.ui	resource
tama_space_bridge.basic-conversation-media-conversation	resource
tama_space_bridge.basic-conversation-memovee	resource
tama_space_bridge.basic-conversation-memovee-ui	resource
tama_space_bridge.media-conversation-to-memovee	resource
tama_space_bridge.media-conversation-to-memovee-ui	resource
tama_space_bridge.media-conversation-to-movie-db	resource
tama_space_bridge.memovee-basic	resource
tama_space_bridge.memovee-media	resource
tama_space_bridge.memovee-ui	resource
tama_space_processor.default-completion	resource
tama_space_processor.default-embedding	resource
tama_space_processor.default-reranking	resource
tama_specification.memovee-ui	resource
tama_thought_context.marking-routing-context	resource
tama_thought_context.personalization-routing-context	resource
tama_thought_path.check-profile-reply	resource
tama_thought_path.forward-curse-reply	resource
tama_thought_path.forward-manipulation-reply	resource
tama_thought_path.forward-marking-media-browsing	resource
tama_thought_path.forward-marking-reply	resource
tama_thought_path.forward-off-topic-reply	resource
tama_thought_path.forward-patch-reply	resource
tama_thought_path.forward-personalization-media-detail	resource
tama_thought_path.forward-personalization-reply	resource
tama_thought_path.forward-upsert-profile	resource
tama_thought_path.route-to-curse	resource
tama_thought_path.route-to-greeting	resource
tama_thought_path.route-to-introductory	resource
tama_thought_path.route-to-manipulation	resource
tama_thought_path.route-to-marking	resource
tama_thought_path.route-to-movie-browsing	resource
tama_thought_path.route-to-movie-detail	resource
tama_thought_path.route-to-off-topic	resource
tama_thought_path.route-to-patch	resource
tama_thought_path.route-to-person-browsing	resource
tama_thought_path.route-to-person-detail	resource
tama_thought_path.route-to-personalization	resource
tama_thought_path_directive.check-profile-artifact	resource
tama_thought_path_directive.check-profile-reply	resource
tama_thought_path_directive.curse-reply	resource
tama_thought_path_directive.forward-patch-artifact	resource
tama_thought_path_directive.forward-patch-reply	resource
tama_thought_path_directive.manipulation-reply	resource
tama_thought_path_directive.marking-artifact	resource
tama_thought_path_directive.marking-reply	resource
tama_thought_path_directive.off-topic-reply	resource
tama_thought_path_directive.personalization-artifact	resource
tama_thought_path_directive.personalization-reply	resource
tama_thought_path_directive.upsert-profile-artifact	resource
tama_thought_path_directive.upsert-profile-reply	resource
tama_thought_processor.artifact-processor	resource
tama_thought_processor.marking-routing-processor	resource
tama_thought_processor.personalization-routing-processor	resource
tama_thought_processor.reply-processor	resource
tama_thought_tool.create-artifact-tool	resource
tama_thought_tool.movie-detail-check-user-preferences	resource
tama_thought_tool.watch-providers	resource
tama_thought_tool_output.watch-providers-output	resource
tama_tool_output_option.watch-providers-region	resource
http_http.memovee-ui	data source
tama_action.create-artifact	data source
tama_action.create-record-markings	data source
tama_action.create-user-preference	data source
tama_action.get-user	data source
tama_action.get-user-preferences	data source
tama_action.list-record-markings	data source
tama_action.update-user	data source
tama_action.update-user-preference	data source

Inputs

Name	Description	Type	Default	Required
anthropic_api_key	The API key for the Anthropic inference service	string	n/a	yes
elasticsearch_endpoint	The endpoint URL of the Elasticsearch instance	string	n/a	yes
elasticsearch_management_api_key	The API key for the Elasticsearch management API	string	n/a	yes
elasticsearch_movie_db_api_key	The API key for the Elasticsearch Movie DB inference service	string	n/a	yes
memovee_listener_secret	The secret for the Memovee UI listener	string	n/a	yes
memovee_ui_client_id	The client ID for the Memovee UI OAuth client	string	n/a	yes
memovee_ui_client_secret	The client secret for the Memovee UI OAuth client	string	n/a	yes
memovee_ui_endpoint	The endpoint URL of the Memovee UI	string	n/a	yes
memovee_ui_openapi_url	The OpenAPI URL of the Memovee UI	string	n/a	yes
mistral_api_key	The API key for the Mistral inference service	string	n/a	yes
openai_api_key	The API key for the OpenAI inference service	string	n/a	yes
router_classification_class_name	The name of the classification class	string	"class"	no
router_classification_properties	The properties of the classification class	list(string)	[ "class", "confidence", "referenced_tool_call_ids" ]	no
tmdb_api_key	The API key for the TMDB inference service	string	n/a	yes
voyageai_api_key	The API key for the VoyageAI inference service	string	n/a	yes
xai_api_key	The API key for the XAI inference service	string	n/a	yes

Outputs

No outputs.