PHPackages                             skrtdev/novagram - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. skrtdev/novagram

ActiveLibrary[CLI & Console](/categories/cli)

skrtdev/novagram
================

An Object-Oriented PHP Library for Telegram Bots

v1.10(5y ago)1885.6k22[3 issues](https://github.com/skrtdev/NovaGram/issues)[1 PRs](https://github.com/skrtdev/NovaGram/pulls)MITPHPPHP >=7.4

Since Jun 22Pushed 2y ago5 watchersCompare

[ Source](https://github.com/skrtdev/NovaGram)[ Packagist](https://packagist.org/packages/skrtdev/novagram)[ RSS](/packages/skrtdev-novagram/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (3)Versions (23)Used By (0)

 [![](https://camo.githubusercontent.com/188d11684d71892ec1fd39e9e28fd357c38ff2d7f9b94fb8a735bad78fda9e43/68747470733a2f2f63646e2e706978616261792e636f6d2f70686f746f2f323032312f30352f30342f31312f31332f74656c656772616d2d363232383334335f3936305f3732302e706e67)](https://camo.githubusercontent.com/188d11684d71892ec1fd39e9e28fd357c38ff2d7f9b94fb8a735bad78fda9e43/68747470733a2f2f63646e2e706978616261792e636f6d2f70686f746f2f323032312f30352f30342f31312f31332f74656c656772616d2d363232383334335f3936305f3732302e706e67)

 NovaGram
===========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#------------novagram)

[![GitHub license](https://camo.githubusercontent.com/e39999b45035464eef53d63b655cf83a6f157a55cd5878020d80637a0f14f32e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f736b72746465762f4e6f76614772616d)](https://github.com/skrtdev/NovaGram/blob/master/LICENSE) [![GitHub stars](https://camo.githubusercontent.com/207654b0e4d0ebfd9d2747c31ac60ffcb68d18833666c45e3eb1e957fcf43fa6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f736b72746465762f4e6f76614772616d)](https://github.com/skrtdev/NovaGram/stargazers) [![Version](https://camo.githubusercontent.com/f8c2fe1a28337511821f19ec6ebbc275b370d9ae38ca92765b4e06c62667319e/68747470733a2f2f706f7365722e707567782e6f72672f736b72746465762f6e6f76616772616d2f76657273696f6e)](https://github.com/skrtdev/NovaGram/releases) [![Total Downloads](https://camo.githubusercontent.com/dadb2034b9345b36c770e87d36d659d3e956add0fdedc826db45e5eb01355f01/68747470733a2f2f706f7365722e707567782e6f72672f736b72746465762f6e6f76616772616d2f646f776e6c6f616473)](https://packagist.org/packages/skrtdev/novagram) [![Total Downloads](https://camo.githubusercontent.com/69a52c336fae5f026a6dacf19da72f235dcb6a993f373f79f32776996040ec64/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d74656c656772616d266d6573736167653d67726f757026636f6c6f723d626c7565266c6f676f3d74656c656772616d)](https://t.me/joinchat/JdBNOEqGheC33G476FiB2g)

***An elegant, Object-Oriented, reliable PHP Telegram Bot Library***

[Full Documentation](https://novagram.gaetano.eu.org) • [Public support group](https://t.me/joinchat/JdBNOEqGheC33G476FiB2g)
[Examples](#-examples) • [Features](#-features) • [Installation](#-installation)

> **🌟 v1.9 has been released:** check changelog [here](https://github.com/skrtdev/NovaGram/blob/master/CHANGELOG.md#v19---source-code)

⚙️ Examples
-----------

[](#️-examples)

An example code of a simple bot.
Works with both getUpdates and Webhooks

```
use skrtdev\NovaGram\Bot;
use skrtdev\Telegram\Message;

$Bot = new Bot('YOUR_TOKEN');

$Bot->onCommand('start', function (Message $message) {
    $message->reply('Hey! Nice to meet you. Use /info to know more about me.');
});

$Bot->onCommand('info', function (Message $message) {
    $message->reply('Well, I\'m just an example, but you can learn more about NovaGram at novagram.gaetano.eu.org');
});
```

📎 Features
----------

[](#-features)

- ***Full***: All the Methods and Types implemented in *Bot Api 5.0* (support **local Bot Api** too)
- ***Fast***: Support for *JSON payload*, and *async handling of updates*
- ***Extendable***: With [Prototypes](https://novagram.gaetano.eu.org/prototypes.html), you can add your *custom functionalities*
- ***Easy***: *Exactly like original Bot Api*, with many methods simplified in a very nice way
- ***Ready***: You can *start creating your amazing bot right now*, thanks to many Built-in features, such as [Conversations](https://novagram.gaetano.eu.org/database.html), [Entities Parser](https://novagram.gaetano.eu.org/objects.html) and [getDC](https://novagram.gaetano.eu.org/docs.html#getUsernameDC)
- ***Secure***: When using Webhooks, there is a *Built-in Telegram IP Check*, that works with Cloudflare too!

### Why another PHP library?

[](#why-another-php-library)

I decided to build my own php library for telegram bot api because all the libraries i found on the web [made it difficult even to do the simplest things](docs/compare.md), such as a sendMessage.
NovaGram is built in order to bring a lightweight alternative to make bots, so that it is simple for beginners, but powerful for who already knows how to implement it.

⬇️ Installation
---------------

[](#️-installation)

### Installation via [Composer](https://getcomposer.org)

[](#installation-via-composer)

Install NovaGram via Composer

```
composer require skrtdev/novagram ^1.9

```

After Installation, include NovaGram with:

```
require 'vendor/autoload.php';
```

### Installation via Phar

[](#installation-via-phar)

Include the `phar` file in your bot file:

```
if (!file_exists('novagram.phar')) {
    copy('https://gaetano.eu.org/novagram/phar.phar', 'novagram.phar');
}
require_once 'novagram.phar';
```

More info in the [Documentation](https://novagram.gaetano.eu.org)

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 99.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~26 days

Recently: every ~99 days

Total

22

Last Release

1610d ago

Major Versions

0.4 → 1.02020-08-24

v1.10 → v2.x-dev2021-12-20

PHP version history (3 changes)0.1PHP ^7.0

v1.0.1PHP >=7.0

v1.3PHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/6ed675ca5cde9cac5fa76de9023a8d3c4ae2b8837f600c4b5c242dc05a016c55?d=identicon)[skrtdev](/maintainers/skrtdev)

---

Top Contributors

[![skrtdev](https://avatars.githubusercontent.com/u/64538010?v=4)](https://github.com/skrtdev "skrtdev (443 commits)")[![code-a1](https://avatars.githubusercontent.com/u/68858676?v=4)](https://github.com/code-a1 "code-a1 (1 commits)")[![giuseppedima](https://avatars.githubusercontent.com/u/118028234?v=4)](https://github.com/giuseppedima "giuseppedima (1 commits)")[![Jobians](https://avatars.githubusercontent.com/u/88005779?v=4)](https://github.com/Jobians "Jobians (1 commits)")

---

Tags

apibotclicomposergetupdateshacktoberfestmtprotooopphptelegramtelegram-apitelegram-bottelegram-botsuserbotwebhooks

### Embed Badge

![Health badge](/badges/skrtdev-novagram/health.svg)

```
[![Health](https://phpackages.com/badges/skrtdev-novagram/health.svg)](https://phpackages.com/packages/skrtdev-novagram)
```

###  Alternatives

[pantheon-systems/terminus

A command line interface for Pantheon

3391.5M13](/packages/pantheon-systems-terminus)[n98/magerun

Tools for managing Magento projects and installations

1.4k264.7k7](/packages/n98-magerun)[kenjis/codeigniter-cli

A command-line tool for CodeIgniter 3.0

10037.1k](/packages/kenjis-codeigniter-cli)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1322.1k12](/packages/mahocommerce-maho)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)