Skip to content

Add TeXada-the-Math-Agent - #11396

Merged
probonopd merged 2 commits into
masterfrom
discover/TeXada-the-Math-Agent
Nov 14, 2026
Merged

probonopd merged 2 commits into
masterfrom
discover/TeXada-the-Math-Agent

Conversation

@probonopd

Copy link
Copy Markdown
Member

Repository: https://github.com/CacinieP/TeXada-the-Math-Agent

Recognize, transcribe and typeset math formulas locally: natural language / image / broken TeX → valid LaTeX with preview

  • Stars: 47
  • Release with the AppImage: v0.4.4 (2026-11-07T16:15:04Z)
  • AppImage asset: TeXada_0.4.4_amd64.AppImage
  • License: AGPL-3.0

Found by .github/workflows/discover-apps.yml, which looks for GitHub
repositories that publish AppImages but are not in the catalog yet. This
entry was not tested by a human; please review it before merging.

Discovered on GitHub as publishing AppImages on its releases, by
discover-apps.yml. Needs a maintainer's review.
@github-actions

github-actions Bot commented Nov 8, 2026 •

Copy link
Copy Markdown
Contributor

File name: no more than two hyphens

An earlier commit of this PR had a file in data/ with more than two hyphens in its name; as of commit a53d547, it no longer does.

@github-actions github-actions Bot added manual-check-needed A maintainer needs to check this PR, see its comments error-app-exits Test failed: the application quit or crashed right after starting error-glibc-too-new Test failed: built on a too new system (needs a newer glibc) labels Nov 8, 2026
@github-actions

github-actions Bot commented Nov 8, 2026

Copy link
Copy Markdown
Contributor

❌ Test failure

@CacinieP: this pull request adds the AppImage from your GitHub repository to the AppImage catalog; the test reports the following. Could you have a look?

Tested:

Compatibility: not self-contained: uses the C library of the system; references glibc 2.39

  • The AppImage needs a newer C library (glibc, or the C++ library libstdc++) than the test system has; the error names the version that is missing (e.g. GLIBC_2.38). The test runs on the oldest Ubuntu LTS release that is still in standard support (see https://ubuntu.com/about/release-cycle), because an AppImage is meant to run on any current Linux distribution, including older ones, and glibc can only be as old as the system the AppImage was built on: a program built on a newer system links against symbols that older systems do not have. The fix is to build on the oldest still-supported LTS release (in GitHub Actions, the oldest ubuntu-* runner still offered, or a container of that release), not on the newest system. If the program itself needs a newer compiler, build in a container of the old release with a newer toolchain (e.g. the toolchain PPAs), statically link what needs it, or bundle the C library together with its dynamic loader (ld-linux) in the AppImage: then the host's glibc does not matter at all (the test reports X-AppImage-Libc=bundled). See https://docs.appimage.org/reference/best-practices.html#binaries-compiled-on-old-enough-base-system
  • The application quit or crashed right after starting; the error below usually shows why. Note that the test runs the application without network access, on purpose, and that this is a requirement for the catalog: an AppImage must start without network (users are offline too). If the application needs a server, a login or an update check to start, please make it show its window (or at least a message) first and connect afterwards, and handle a failed connection instead of exiting.

First error in the log:

texada-shell: /lib/x86_64-linux-gnu/libc.so.6: weak version `GLIBC_2.39' not found (required by texada-shell)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libcrypto.so.3)
texada-shell: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libgdk-3.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libgdk-3.so.0)
texada-shell: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libcairo.so.2)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libcairo.so.2)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libglib-2.0.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libdbus-1.so.3)
texada-shell: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libwebkit2gtk-4.1.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libwebkit2gtk-4.1.so.0)
texada-shell: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libgtk-3.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libgtk-3.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libsoup-3.0.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libgio-2.0.so.0)
texada-shell: /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libjavascriptcoregtk-4.1.so.0)
texada-shell: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by /run/firejail/appimage/usr/lib/libjavascriptcoregtk-4.1.so.0)

What next: once the AppImage is fixed (e.g. in a new release), comment /retest here to test it again. If it should not be in the catalog after all, close this pull request; an app that is already in the catalog can be removed by a maintainer with /remove.

Commit ff74fd0. Full log

@CacinieP

CacinieP commented Nov 9, 2026

Copy link
Copy Markdown

Thanks for discovering TeXada and for the compatibility report!

The v0.4.4 Linux package was built on Ubuntu 24.04, which explains the newer glibc requirements. I have opened a fix in CacinieP/TeXada-the-Math-Agent#74 to:

  • build the Linux desktop and Python backend on Ubuntu 22.04 (glibc 2.35);
  • build the pinned llama-server from source on the same baseline instead of using an upstream Ubuntu binary;
  • check packaged ELF glibc imports and exercise both the deb and AppImage with external networking disabled, while retaining loopback for the local backend.

The regular audit checks have passed; the new Linux package build/startup validation is still running. A corrected AppImage has not been released yet, so I am not requesting a retest at this stage. Once a validated replacement is published, I will follow up here and request a retest.

Regarding the filename warning: TeXada-the-Math-Agent is the repository/project name, and its hyphens do not represent a version or architecture. The desktop application's display name is TeXada, so data/TeXada would be appropriate if the catalog entry should follow the application name rather than the repository name.

@github-actions github-actions Bot added the needs-maintainer Blocked on a maintainer: passed and waiting for review, or flagged for a manual check label Nov 9, 2026
@CacinieP

Copy link
Copy Markdown

/retest

@probonopd probonopd closed this Nov 14, 2026
@probonopd probonopd reopened this Nov 14, 2026
@github-actions github-actions Bot added error-not-english Test failed: see the test result comment and removed error-app-exits Test failed: the application quit or crashed right after starting error-glibc-too-new Test failed: built on a too new system (needs a newer glibc) labels Nov 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🌏 An invitation / 邀请

你好!非常感谢你制作了这个 AppImage!👋

我们注意到这个应用的界面或说明文档主要是中文的。AppImage 目录面向全球用户,默认以英文显示界面的应用可以被收录,并有机会触达世界各地更多的用户。

想请教一下:这个应用是否也可能对国际用户有帮助?如果是的话,作者是否愿意考虑把英文设为默认语言呢(例如根据系统语言环境 LANG / LC_* 自动选择,在非中文环境下回退到英文)?这样它就能被收录到目录中,让更多国际用户发现并使用它。

当然,在中文环境下依然可以默认显示中文——我们只是希望在其他语言环境下能有英文界面。🙏


Hi there, and thank you for making this AppImage! 👋

We noticed that this application's interface or documentation appears to be predominantly in Chinese. The catalog serves a worldwide audience, and applications that show an English interface by default can be included and reach many more users internationally.

Might this application also be of interest to users outside China? If so, would you consider making English the default — for example by following the system locale (LANG / LC_*) and falling back to English outside a Chinese locale? That would let us include it in the catalog so that many more people around the world can discover and enjoy it.

Chinese can of course remain the default in a Chinese locale — we would simply love an English fallback elsewhere. Thank you so much, and we look forward to your thoughts! 🙏

TeXada-the-Math-Agent

TeXada-the-Math-Agent

Commit ff74fd0. Full log

@CacinieP

Copy link
Copy Markdown

Thanks for the locale feedback. We added system-locale selection in TeXada PR #90. On a fresh profile, Chinese locales get Chinese and other locales fall back to English. Explicit language choices are preserved.

We verified the corrected AppImage on Ubuntu 22.04 in CI and on a separate Ubuntu 24.04.5 x86_64 machine under Xvfb with LC_ALL=C.UTF-8. The first window showed English. On the Ubuntu 24.04 machine, we also ran the bundled CPU MiniCPM-V model for two formula transcription requests and one image-to-LaTeX request.

This was a CI-built candidate. The corrected binary is not yet in a public release, so please hold off on a catalog retest until the release is available.

@CacinieP

CacinieP commented Nov 14, 2026 •

Copy link
Copy Markdown

Thanks for flagging the default language. The fix is in TeXada PR #90. On a fresh profile, TeXada uses Chinese for Chinese locales and English otherwise, and preserves an explicit language selection.

We tested the corrected x86_64 AppImage on Ubuntu 24.04.5 LTS, with an Intel Core i5-7200U (2 cores, 4 threads) and 11 GiB of RAM reported by Linux. In a fresh Xvfb session with LC_ALL=C.UTF-8, the first window displayed English. The bundled MiniCPM-V 4.7 1B also ran on the CPU and produced valid LaTeX in English and Chinese transcription tests and in an image-to-LaTeX test. English first-window screenshot

Could a maintainer rename data/TeXada-the-Math-Agent to data/TeXada in this PR to match the application display name? The file should still contain just https://github.com/CacinieP/TeXada-the-Math-Agent. I have read access to the discovery branch, so the rename needs to be applied by a maintainer.

The validated build is a CI artifact. I’ll request a catalog retest after the corrected AppImage is available in a public release.

Build for manual review: download the tested locale-corrected Linux bundle from GitHub Actions. Inside the ZIP, use TeXada_0.4.9_amd64.AppImage (SHA-256 bce835067f9fe2ab026830f60a4be1f412b968f89a20baca3c9e2bfa8e846a2f). This is the same binary shown in the screenshot above. The v0.4.10 public release build is in progress.

TeXada v0.4.10 is now publicly available with the locale fix: release · x86_64 AppImage. The released AppImage passed the English-window and offline startup checks on Ubuntu 22.04. Released installer validation.

@github-actions github-actions Bot removed the manual-check-needed A maintainer needs to check this PR, see its comments label Nov 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🌏 An invitation / 邀请

你好!非常感谢你制作了这个 AppImage!👋

我们注意到这个应用的界面或说明文档主要是中文的。AppImage 目录面向全球用户,默认以英文显示界面的应用可以被收录,并有机会触达世界各地更多的用户。

想请教一下:这个应用是否也可能对国际用户有帮助?如果是的话,作者是否愿意考虑把英文设为默认语言呢(例如根据系统语言环境 LANG / LC_* 自动选择,在非中文环境下回退到英文)?这样它就能被收录到目录中,让更多国际用户发现并使用它。

当然,在中文环境下依然可以默认显示中文——我们只是希望在其他语言环境下能有英文界面。🙏


Hi there, and thank you for making this AppImage! 👋

We noticed that this application's interface or documentation appears to be predominantly in Chinese. The catalog serves a worldwide audience, and applications that show an English interface by default can be included and reach many more users internationally.

Might this application also be of interest to users outside China? If so, would you consider making English the default — for example by following the system locale (LANG / LC_*) and falling back to English outside a Chinese locale? That would let us include it in the catalog so that many more people around the world can discover and enjoy it.

Chinese can of course remain the default in a Chinese locale — we would simply love an English fallback elsewhere. Thank you so much, and we look forward to your thoughts! 🙏

TeXada

TeXada

Commit a53d547. Full log

@CacinieP

Copy link
Copy Markdown

/retest

@probonopd probonopd closed this Nov 14, 2026
@probonopd probonopd reopened this Nov 14, 2026
@github-actions github-actions Bot removed the error-not-english Test failed: see the test result comment label Nov 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

✅ Test passed

Please check that the screenshot shows the application's main window.

TeXada

TeXada

Tested:

Compatibility: not self-contained: uses the C library of the system; references glibc 2.35

Suggestions for improving the AppImage:

  • The window is mostly dark, so the application seems to start in a dark theme although the test system is not set to dark mode. Please use a light mode by default and use the dark theme only when the system is configured for dark mode (e.g. the GTK/Qt or theme setting) or the user chooses it in the settings.
  • The AppImage contains no update information, so users cannot update it with AppImageUpdate or similar tools. Please consider embedding it when building the AppImage (e.g., appimagetool -u) and publishing the .zsync file next to the AppImage; see https://docs.appimage.org/packaging-guide/optional/updates.html

Commit a53d547. Full log

@CacinieP

Copy link
Copy Markdown

I checked the v0.4.10 screenshot and it shows TeXada’s main window with English navigation. Thanks for renaming the catalog entry to data/TeXada and for the packaging suggestions. The tested release is ready for maintainer review.

@probonopd
probonopd merged commit b0af1b5 into master Nov 14, 2026
5 of 6 checks passed
@probonopd
probonopd deleted the discover/TeXada-the-Math-Agent branch November 14, 2026 22:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-discovered needs-maintainer Blocked on a maintainer: passed and waiting for review, or flagged for a manual check

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants