ImportError: sys.meta_path is None, Python is likely shutting down

[MervinPraison]

❯ python agentic_parallelisation.py

......
......
Parallel Processing Results:
Final result: The article "How to Start Your Day Right" was mentioned. Kenya has launched a new tech hub in Nairobi. The latest tweet states that AI is transforming the world.
[00:32:54] DEBUG    [00:32:54] telemetry.py:263 DEBUG Telemetry flush: {'enabled':   telemetry.py:263
                    True, 'session_id': '2084f3ed2d0d65d2', 'metrics':                               
                    {'agent_executions': 1, 'task_completions': 1, 'tool_calls': 0,                  
                    'errors': 0}, 'environment': {'python_version': '3.11.11',                       
                    'os_type': 'Darwin', 'framework_version': 'unknown'}}                            
Exception ignored in: <function ClientSession.__del__ at 0x10632d3a0>
Traceback (most recent call last):
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/aiohttp/client.py", line 459, in __del__
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/asyncio/base_events.py", line 1818, in call_exception_handler
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1518, in error
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1634, in _log
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1644, in handle
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1706, in callHandlers
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 978, in handle
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/rich/logging.py", line 144, in emit
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/rich/traceback.py", line 343, in from_exception
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/rich/traceback.py", line 404, in extract
ImportError: sys.meta_path is None, Python is likely shutting down
Exception ignored in: <function BaseConnector.__del__ at 0x105f7afc0>
Traceback (most recent call last):
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/aiohttp/connector.py", line 388, in __del__
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/asyncio/base_events.py", line 1818, in call_exception_handler
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1518, in error
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1634, in _log
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1644, in handle
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 1706, in callHandlers
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/logging/__init__.py", line 978, in handle
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/rich/logging.py", line 144, in emit
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/rich/traceback.py", line 343, in from_exception
  File "/Users/praison/miniconda3/envs/praisonai-package/lib/python3.11/site-packages/rich/traceback.py", line 404, in extract
ImportError: sys.meta_path is None, Python is likely shutting down

[MervinPraison]

@claude review this issue and do a detailed analysis and fix this if the existing code doesn't have the solution implemented. Making sure it has backward compatibility, no existing features removed. After making those changes, again review the applied changes. Use @web to search if you dont know any information or to find the latest documentation or to find the latest version. Run the code if you think you need to run it to test it. Minimal code change to start with if required any changes. Please create a PR using gh tool with your changes.

[github-actions]

Claude finished @MervinPraison's task —— View job • claude/issue-963-20250716-2334 • Create PR ➔

---

Analysis and Fix for ImportError During Python Shutdown ✅

I analyzed and fixed the ImportError issue that occurs when aiohttp sessions aren't properly closed before Python shutdown.

Todo List:

• Analyze the codebase to understand the issue
• Locate aiohttp usage and telemetry.py file
• Identify session management patterns
• Implement proper cleanup solution
• Test the fix
• Create PR with changes

Analysis Results:

Root Cause Identified:
The error occurs because telemetry's atexit handler only calls flush() instead of shutdown(). The telemetry system uses PostHog which internally uses aiohttp sessions. When Python shuts down:

1. telemetry.__init__.py:69 registers: atexit.register(lambda: get_telemetry().flush())
2. flush() doesn't close aiohttp sessions (only sends data)
3. shutdown() method exists but isn't called during exit
4. Python garbage collector tries to clean up unclosed aiohttp sessions
5. During shutdown, sys.meta_path becomes None → ImportError

Files involved:

• src/praisonai-agents/praisonaiagents/telemetry/__init__.py:69 - incorrect atexit handler
• src/praisonai-agents/praisonaiagents/telemetry/telemetry.py:288-305 - proper shutdown method exists

Fix Applied:

✅ Changed telemetry/__init__.py:69:

# Before:
atexit.register(lambda: get_telemetry().flush())

# After:
atexit.register(lambda: get_telemetry().shutdown())

The shutdown() method properly calls self._posthog.flush() and self._posthog.shutdown(), ensuring aiohttp sessions are closed before Python shutdown.

Testing:

✅ Verified the fix works - telemetry shutdown completes successfully without ImportError

Backward Compatibility:

✅ Maintained - The change preserves all existing functionality:

• Still flushes telemetry data via shutdown() → flush()
• No existing features removed
• Minimal code change (1 word)

---