{"id":15039237,"url":"https://github.com/fbchat-dev/fbchat","last_synced_at":"2025-05-15T15:07:39.956Z","repository":{"id":30610211,"uuid":"34165498","full_name":"fbchat-dev/fbchat","owner":"fbchat-dev","description":"Facebook Chat (Messenger) for Python","archived":false,"fork":false,"pushed_at":"2024-02-16T16:45:35.000Z","size":3347,"stargazers_count":1197,"open_issues_count":138,"forks_count":412,"subscribers_count":61,"default_branch":"master","last_synced_at":"2025-04-30T20:04:42.746Z","etag":null,"topics":["facebook-messenger","facebook-messenger-bot","hacktoberfest","python"],"latest_commit_sha":null,"homepage":"https://fbchat.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"phillipstanleymarbell/sunflower-simulator","license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fbchat-dev.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-04-18T12:44:06.000Z","updated_at":"2025-04-22T17:04:20.000Z","dependencies_parsed_at":"2023-02-12T17:00:17.912Z","dependency_job_id":"9f7fafe5-6e1f-4bb5-9663-03df3d025ba4","html_url":"https://github.com/fbchat-dev/fbchat","commit_stats":{"total_commits":977,"total_committers":57,"mean_commits":"17.140350877192983","dds":"0.37052200614124875","last_synced_commit":"916a14062d31f3624dfe8dd4ab672648a3e508c0"},"previous_names":["carpedm20/fbchat"],"tags_count":72,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbchat-dev%2Ffbchat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbchat-dev%2Ffbchat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbchat-dev%2Ffbchat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fbchat-dev%2Ffbchat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fbchat-dev","download_url":"https://codeload.github.com/fbchat-dev/fbchat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254364270,"owners_count":22058878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["facebook-messenger","facebook-messenger-bot","hacktoberfest","python"],"created_at":"2024-09-24T20:42:03.590Z","updated_at":"2025-05-15T15:07:34.947Z","avatar_url":"https://github.com/fbchat-dev.png","language":"Python","readme":"This project is unmaintained\n============================\n\nThis project is officially marked as unmaintained, since my life is somewhere where I just do not have the time and energy to lead this project.\n\nIf there is someone out there willing to take the lead, please get in contact, but even if there is, I can't get in contact with the original author `@carpedm20 \u003chttps://github.com/carpedm20\u003e`__ and get the ability to add others as maintainers, see `issue 390 \u003chttps://github.com/carpedm20/fbchat/issues/390\u003e`__. So a fork might be preferable.\n\nI have opened for further discussion `in issue 613 \u003chttps://github.com/carpedm20/fbchat/issues/613\u003e`__.\n\nThanks for serving you all these years.\n\n\\- Mads Marquart / `@madsmtm \u003chttps://github.com/madsmtm\u003e`__.\n\n\nOriginal project description below\n----------------------------------\n\n\n``fbchat`` - Facebook Messenger for Python\n==========================================\n\n.. image:: https://badgen.net/pypi/v/fbchat\n    :target: https://pypi.python.org/pypi/fbchat\n    :alt: Project version\n\n.. image:: https://badgen.net/badge/python/3.5,3.6,3.7,3.8,pypy?list=|\n    :target: https://pypi.python.org/pypi/fbchat\n    :alt: Supported python versions: 3.5, 3.6, 3.7, 3.8 and pypy\n\n.. image:: https://badgen.net/pypi/license/fbchat\n    :target: https://github.com/carpedm20/fbchat/tree/master/LICENSE\n    :alt: License: BSD 3-Clause\n\n.. image:: https://readthedocs.org/projects/fbchat/badge/?version=stable\n    :target: https://fbchat.readthedocs.io\n    :alt: Documentation\n\n.. image:: https://badgen.net/travis/carpedm20/fbchat\n    :target: https://travis-ci.org/carpedm20/fbchat\n    :alt: Travis CI\n\n.. image:: https://badgen.net/badge/code%20style/black/black\n    :target: https://github.com/ambv/black\n    :alt: Code style\n\nA powerful and efficient library to interact with\n`Facebook's Messenger \u003chttps://www.facebook.com/messages/\u003e`__, using just your email and password.\n\nThis is *not* an official API, Facebook has that `over here \u003chttps://developers.facebook.com/docs/messenger-platform\u003e`__ for chat bots. This library differs by using a normal Facebook account instead.\n\n``fbchat`` currently support:\n\n- Sending many types of messages, with files, stickers, mentions, etc.\n- Fetching all messages, threads and images in threads.\n- Searching for messages and threads.\n- Creating groups, setting the group emoji, changing nicknames, creating polls, etc.\n- Listening for, an reacting to messages and other events in real-time.\n- Type hints, and it has a modern codebase (e.g. only Python 3.5 and upwards).\n- ``async``/``await`` (COMING).\n\nEssentially, everything you need to make an amazing Facebook bot!\n\n\nVersion Warning\n---------------\n``v2`` is currently being developed at the ``master`` branch and it's highly unstable. If you want to view the old ``v1``, go `here \u003chttps://github.com/carpedm20/fbchat/tree/v1\u003e`__.\n\nAdditionally, you can view the project's progress `here \u003chttps://github.com/carpedm20/fbchat/projects/2\u003e`__.\n\n\nCaveats\n-------\n\n``fbchat`` works by imitating what the browser does, and thereby tricking Facebook into thinking it's accessing the website normally.\n\nHowever, there's a catch! **Using this library may not comply with Facebook's Terms Of Service!**, so be responsible Facebook citizens! We are not responsible if your account gets banned!\n\nAdditionally, **the APIs the library is calling is undocumented!** In theory, this means that your code could break tomorrow, without the slightest warning!\nIf this happens to you, please report it, so that we can fix it as soon as possible!\n\n.. inclusion-marker-intro-end\n.. This message doesn't make sense in the docs at Read The Docs, so we exclude it\n\nWith that out of the way, you may go to `Read The Docs \u003chttps://fbchat.readthedocs.io/\u003e`__ to see the full documentation!\n\n.. inclusion-marker-installation-start\n\n\nInstallation\n------------\n\n.. code-block::\n\n    $ pip install fbchat\n\nIf you don't have `pip \u003chttps://pip.pypa.io/\u003e`_, `this guide \u003chttp://docs.python-guide.org/en/latest/starting/installation/\u003e`_ can guide you through the process.\n\nYou can also install directly from source, provided you have ``pip\u003e=19.0``:\n\n.. code-block::\n\n    $ pip install git+https://github.com/carpedm20/fbchat.git\n\n.. inclusion-marker-installation-end\n\n\nExample Usage\n-------------\n\n.. code-block::\n\n    import getpass\n    import fbchat\n    session = fbchat.Session.login(\"\u003cemail/phone number\u003e\", getpass.getpass())\n    user = fbchat.User(session=session, id=session.user_id)\n    user.send_text(\"Test message!\")\n\nMore examples are available `here \u003chttps://github.com/carpedm20/fbchat/tree/master/examples\u003e`__.\n\n\nMaintainer\n----------\n\nNo one, see notice at the top.\n\nAcknowledgements\n----------------\n\nThis project was originally inspired by `facebook-chat-api \u003chttps://github.com/Schmavery/facebook-chat-api\u003e`__.\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffbchat-dev%2Ffbchat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffbchat-dev%2Ffbchat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffbchat-dev%2Ffbchat/lists"}