Skip to main content

​
Installation overview

TeeBI provides an automatic installation tool that detects your IDEs, recompiles packages, and configures library paths. Follow the steps below to get TeeBI installed and ready to use.

​
Prerequisites

Before installing TeeBI, ensure you have:
  • RAD Studio XE4 or later (Delphi or C++), or Lazarus v4 with FreePascal 3.2.2
  • Administrator privileges (required for copying files to Windows system folders)
  • Git (optional, for cloning the repository)
For macOS, iOS, and Linux platforms, ensure the appropriate RAD Studio SDKs are already installed before running the TeeBI installation tool.

​
Installation steps

1

Download or clone TeeBI

Get the TeeBI source code from the repository:
git clone https://github.com/Steema/BI.git
Or download the ZIP file and extract it to a local directory.
2

Extract the installer tool

Navigate to the install folder in the TeeBI repository and extract the contents of TeeBIRecompile.zip.This archive contains the automatic installation tool TeeBIRecompile.exe.
3

Run the installer as Administrator

Right-click TeeBIRecompile.exe and select “Run as Administrator”.
Administrator mode is required because the installer copies runtime BPL packages to Windows system folders (System32/SysWOW64).
The installer will:
  • Detect all supported Delphi/C++ RAD Studio IDEs installed on your system
  • Check for TeeChart installations (Lite, Standard, or Pro versions)
  • Allow you to select platforms for recompilation
  • Recompile TeeBI packages from the packages\Temp subfolder
  • Install design-time packages (DCLVCLxxx and DCLFMXxxx)
  • Copy runtime BPL packages to Windows system folders
  • Configure search, library, and browsing paths automatically
4

Verify installation

Open your IDE and verify that TeeBI components appear in the Tool Palette:
  • VCL: Look for TBIGrid and TBIChart components
  • FireMonkey: Look for FMX equivalents
You can also check that the library paths have been added:
  • Go to Tools > Options > Language > Delphi > Library
  • Verify that TeeBI source paths appear in the Library Path

​
Lazarus/FreePascal installation

For Lazarus developers:
1

Locate Lazarus units

TeeBI units compatible with Lazarus are copied to the sources\Lazarus folder during package compilation.
Some units that are not compatible or not yet ported to Lazarus are excluded from this folder.
2

Open the TeeBI package

In Lazarus IDE, open the TeeBI.lpk package file located in the packages folder.
3

Configure source paths

When rebuilding the TeeBI package inside Lazarus, you may need to add the “Sources” path manually:
  • Go to Tools > Options
  • Add the TeeBI sources path to the compiler search paths
4

Compile and install

Compile and install the TeeBI package within Lazarus IDE.

​
Add TeeBI units to your project

Once installed, add TeeBI units to your Delphi/Pascal project’s uses clause: 
uses
  BI.DataItem,   // Core TDataItem class
  BI.CSV,        // CSV import/export
  BI.Db,         // Database import
  BI.Json,       // JSON import/export
  BI.Xml,        // XML import/export
  BI.SQL,        // SQL-like queries
  VCLBI.Grid,    // TBIGrid component (VCL)
  VCLBI.Chart;   // TBIChart component (VCL)
For FireMonkey applications, use the FMX equivalents: 
uses
  BI.DataItem,
  BI.CSV,
  BI.Db,
  FMXBI.Grid,    // TBIGrid component (FMX)
  FMXBI.Chart;   // TBIChart component (FMX)

​
Platform-specific considerations

​
Windows

No additional configuration required. The installer handles all necessary setup.

​
macOS, iOS, and Linux

Before selecting these platforms in the installer, ensure you have already installed the RAD Studio SDKs for the target platforms.
The installer will recompile packages for selected platforms, but the base SDK must be present.

​
Mobile platforms (Android/iOS)

Mobile platforms require FireMonkey. Use the FMX-specific TeeBI units: 
uses
  FMXBI.Grid, FMXBI.Chart;

​
Troubleshooting

Ensure the design-time packages were installed successfully:
  • Go to Component > Install Packages
  • Verify that DCLVCLTeeBIxxx or DCLFMXTeeBIxxx packages are listed
  • If missing, manually install from the compiled BPL files
Check that library paths are configured correctly:
  • Go to Tools > Options > Language > Delphi > Library
  • Ensure TeeBI source paths are present
  • For Lazarus, add paths manually in IDE Options
The installer requires administrator privileges to copy BPL files to system folders:
  • Right-click TeeBIRecompile.exe
  • Select “Run as Administrator”
  • Accept the UAC prompt

​
Next steps

Quickstart

Build your first TeeBI application

Core concepts

Learn about TDataItem and TeeBI architecture

Build docs developers (and LLMs) love

Get started for freeTalk to us