A comprehensive collection of AI assistant skills for working with Apache IoTDB and Apache TsFile. These skills provide detailed guidance, code examples, and best practices for developers working with time-series data storage and IoT applications.
This repository contains two specialized skills designed to enhance AI assistant capabilities when helping developers work with:
- IoTDB - A low-cost, high-performance IoT-native time-series database
- TsFile - Open-source File Format for Industrial Time-Series Datasets
Purpose: Comprehensive guide for connecting to and working with Apache IoTDB across multiple programming languages and data models.
Features:
- Multi-language support (Java, Python, C++, REST API)
- Dual data model support (Tree Model & Table Model)
- Connection methods:
- Java SessionPool (production-recommended)
- JDBC interface
- Python client
- C++ client
- REST API
- Best practices for production deployments
- Memory-efficient data reading patterns
- Integration examples (Spring Boot, MyBatis)
Use Cases:
- Establishing IoTDB database connections
- Implementing data insertion and querying
- Configuring database sessions
- Building IoT monitoring applications
- Time-series data analytics
Path: iotdb/
Purpose: Toolkit for working with Apache TsFile format for time-series data storage and processing.
Features:
- Multi-language support (Java, Python, C++, C)
- Read/write operations for TsFile format
- Schema design and optimization
- Batch processing for high performance
- Cross-language data exchange
- Integration with big data frameworks
Use Cases:
- Reading and writing TsFile files
- Time-series data storage optimization
- IoT data processing pipelines
- Data format conversion
- Performance tuning for large datasets
Path: tsfile/
These skills are designed to be loaded into AI assistant systems (like Claude with MCP or similar frameworks) to provide specialized knowledge about IoTDB and TsFile.
Each skill contains:
SKILL.md- Main skill definition and documentationreferences/- Detailed technical references and examplesassets/- Code templates and configuration filesscripts/- Utility scripts for testing and validation
Use these resources as comprehensive reference documentation:
-
IoTDB Development:
- Browse iotdb/SKILL.md for connection guides
- Check iotdb/references/ for language-specific examples
- Use templates in iotdb/assets/connection_templates/
-
TsFile Development:
- Browse tsfile/SKILL.md for file format operations
- Check tsfile/references/ for API documentation
- Use examples in tsfile/assets/
timecho-skills/
├── iotdb/ # IoTDB connection and usage guide
│ ├── SKILL.md # Main skill documentation
│ ├── references/ # Language-specific guides
│ │ ├── java_examples_priority.md
│ │ ├── python_examples.md
│ │ ├── cpp_examples.md
│ │ ├── rest_api.md
│ │ ├── jdbc_examples.md
│ │ ├── spring_boot_integration.md
│ │ ├── mybatis_integration.md
│ │ └── data_models.md
│ ├── assets/
│ │ └── connection_templates/
│ └── scripts/ # Validation and testing scripts
│
├── tsfile/ # TsFile format toolkit
│ ├── SKILL.md # Main skill documentation
│ ├── references/ # API references
│ │ └── api_reference.md
│ ├── assets/ # Code examples and config
│ │ ├── TsFileExample.java
│ │ ├── tsfile_example.py
│ │ ├── tsfile_example.cpp
│ │ └── pom.xml
│ └── scripts/ # Build and example scripts
│
└── LICENSE # Apache License 2.0
SessionPool sessionPool = new SessionPool.Builder()
.host("127.0.0.1")
.port(6667)
.user("root")
.password("root")
.maxSize(10)
.build();
try (SessionDataSet dataSet = sessionPool.executeQueryStatement("SELECT * FROM root.factory.**")) {
DataIterator iterator = dataSet.iterator();
while (iterator.next()) {
System.out.println("Time: " + iterator.getLong(1) + ", Value: " + iterator.getFloat(2));
}
}from tsfile import TsFileTableWriter, TsFileReader, TableSchema
# Write data
with TsFileTableWriter("data.tsfile", schema) as writer:
writer.write_table(tablet)
# Read data
with TsFileReader("data.tsfile") as reader:
df = reader.read_table(table_name)- Java: IoTDB Java API (SessionPool/JDBC)
- Python:
apache-iotdbpackage - C++: IoTDB C++ client library
- REST: HTTP client (any language)
- Java: Maven/Gradle with TsFile dependencies
- Python: TsFile Python package (requires C++ build)
- C++: CMake and TsFile C++ library
- C: TsFile C bindings
Contributions are welcome! Please ensure:
- Code examples follow best practices
- Documentation is clear and accurate
- Examples are tested and working
- Follow the existing structure and style
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Both Apache IoTDB and Apache TsFile are Apache Software Foundation projects licensed under Apache 2.0. All code examples and templates in this repository follow the same license for compatibility.
- Apache IoTDB - Official IoTDB website
- Apache TsFile - TsFile repository
- IoTDB Documentation - Official documentation
Use IoTDB skill to build real-time monitoring systems for sensors, devices, and industrial equipment with high-throughput data ingestion.
Leverage both skills to process and analyze large-scale time-series datasets with efficient storage and query capabilities.
Integrate IoTDB with existing Java applications using Spring Boot and MyBatis integration patterns provided in the IoTDB skill.
Use TsFile skill to export, share, and archive time-series data in a portable, efficient columnar format.
For issues related to:
- These skills: Open an issue in this repository
- Apache IoTDB: Visit IoTDB GitHub
- Apache TsFile: Visit TsFile GitHub
Maintained by Timecho Lab