Skip to content

Tinystruct

A lightweight, modular Java application framework for web and CLI development, designed for AI integration and plugin-based architecture. Enabling developers to create robust…

Install

$git clone https://github.com/tinystruct/tinystruct

Install command taken from the project's README or registry entry. Always review code before running it.

"How many are your works, O LORD ! In wisdom you made them all; the earth is full of your creatures." Psalms 104:24

Language: English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย | Deutsch | Español

The tinystruct framework

A simple framework for Java development. Simple thinking, Better design, Easy to be used with better performance!

Prerequisites

  • Java Development Kit (JDK) 17 or higher
  • Maven (for dependency management)
  • A text editor or IDE (IntelliJ IDEA, Eclipse, VS Code, etc.)

Getting Started with tinystruct archetype

You can follow this archetype to create a tinystruct-based project quickly: https://github.com/tinystruct/tinystruct-archetype

Installation and Getting Started Manually

  • Add the dependency into your pom.xml.
<dependency>
  <groupId>org.tinystruct</groupId>
  tinystruct</artifactId>
  <version>1.7.35</version>
</dependency>

To use the framework as a standalone command-line tool, build the optional jar that bundles all dependencies (about 50 MB, not part of the release):

./mvnw package -Pstandalone        # Windows: mvnw.cmd package -Pstandalone
java -jar target/tinystruct-1.7.35-jar-with-dependencies.jar --help
  • Extend the AbstractApplication in Java:
package tinystruct.examples;

import org.tinystruct.AbstractApplication;
import org.tinystruct.ApplicationException;
import org.tinystruct.system.annotation.Action;

public class example extends AbstractApplication {

    @Override
    public void init() {
        // TODO Auto-generated method stub
    }

    @Override
    public String version() {
        return "1.0";
    }

    @Action("praise")
    public String praise() {
        return "Praise the Lord!";
    }

    @Action("say")
    public String say() throws ApplicationException {
        if (null != getContext().getAttribute("--words"))
            return getContext().getAttribute("--words").toString();

        throw new ApplicationException("Could not find the parameter <i>words</i>.");
    }

    @Action("say")
    public String say(String words) {
        return words;
    }

    @Action(value = "hello", mode = Mode.HTTP_GET)
    public String helloGet() {
        return "GET";
    }

    @Action(value = "hello", mode = Mode.HTTP_POST)
    public String helloPost() {
        return "POST";
    }

}

Smalltalk: https://github.com/tinystruct/smalltalk

Execute in CLI mode

$ bin/dispatcher --version

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…