Modules API

Modules are the basic building blocks of programs in Synalinks. A Module consists of data model-in & data model-out computation function (the module's call() method) and some state (held in Variable).

A module instance is a callable, much like a function:

import synalinks
import asyncio

class Query(synalinks.DataModel):
    query: str = synalinks.Field(
        description="The user query",
    )

class AnswerWithThinking(synalinks.DataModel):
    thinking: str = synalinks.Field(
        description="Your step by step thinking",
    )
    answer: str = synalinks.Field(
        description="The correct answer",
    )

async def main():
    language_model = LanguageModel(
        model="ollama/deepseek-r1"
    )

    generator = synalinks.Generator(
        data_model=AnswerWithThinking,
        language_model=language_model,
    )

    inputs = Query(query="What is the capital of France?")
    outputs = await generator(inputs)


if __name__ == "__main__":
    asyncio.run(main())

Modules API overview

• Base Module class

---

Core Modules

• Input module
• Identity module
• Not module
• Generator module
• Decision module
• MultiDecision module
• Action module
• Branch module

---

Merging Modules

• Concat module
• And module
• Or module
• Xor module

---

Test Time Compute Modules

• ChainOfThought module
• SelfCritique module

---

Knowledge Modules

• Embedding module
• UpdateKnowledge module
• EntityRetriever module
• KnowledgeRetriever module

---

Agents Modules

• ReACT Agent module
• Parallel ReACT Agent module